home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / imail121.zip / IMAIL.DOC < prev    next >
Text File  |  1991-11-06  |  248KB  |  6,047 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                            █┐ █▀▀▀█┐ █▀▀█┐ █┐ █┐
  21.                            █│ █│█┐█│ █│▀█│ █│ █│
  22.                            █│ █│└┘█│ █│ █│ █│ █│
  23.                            █│ █│  █│ █│ █│ █│ █▄▄▄┐
  24.                            └┘ └┘  └┘ └┘ └┘ └┘  └──┘
  25.  
  26.                            V e r s i o n    1 . 2 1
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                      Copyright 1990, 1991 by Fabiano Fabris
  35.                              for Intuition Software
  36.  
  37.                                All Rights Reserved
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                         ┌──────────────────────────────┐
  48.                         │         Dedicated to         │
  49.                         │        Marco Manzocco        │
  50.                         │   and all the beta testers   │
  51.                         └──────────────────────────────┘
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.     ════════════════════════════════════════════════════════════════════════
  68.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  69.     ════════════════════════════════════════════════════════════════════════
  70.  
  71.  
  72.                            ═══ TABLE OF CONTENTS ═══
  73.  
  74.     1. INTRODUCTION .................................................... 1
  75.  
  76.     2. WARRANTY AND REGISTRATION INFORMATION ........................... 2
  77.        a. Standard Disclaimer .......................................... 3
  78.  
  79.     3. ACKNOWLEDGEMENTS ................................................ 4
  80.        a. Copyrights ................................................... 4
  81.  
  82.     4. INSTALLATION .................................................... 5
  83.        a. Environment Variables ........................................ 5
  84.           1) IMAIL ..................................................... 5
  85.           2) POINTNET .................................................. 5
  86.        b. System Requirements .......................................... 6
  87.           1) Hardware .................................................. 6
  88.           2) Software .................................................. 6
  89.           3) Networks & File Sharing ................................... 6
  90.        c. Upgrading from Previous Versions ............................. 7
  91.  
  92.     5. IMSETUP ......................................................... 8
  93.        a. General Configuration ........................................ 8
  94.           1) System Addresses .......................................... 8
  95.           2) Domain Names .............................................. 9
  96.           3) Subdirectories ............................................ 9
  97.              - QBBS/RA System .......................................... 9
  98.              - Net Mail Message ........................................ 10
  99.              - Inbound Net Files ....................................... 10
  100.              - Outbound Net Files ...................................... 10
  101.              - IMAIL Log File Name ..................................... 10
  102.              - Auto-Added Areas Log .................................... 11
  103.              - Log Format .............................................. 11
  104.              - Bad Message Board ....................................... 11
  105.              - Dupe Message Board ...................................... 11
  106.              - Default Origin .......................................... 12
  107.           4) AreaLink Options .......................................... 12
  108.              - Keep AreaLink Receipt ................................... 12
  109.              - Allow Rescan Request .................................... 12
  110.              - AreaLink Help Text ...................................... 13
  111.              - Forward Link Requests (R) ............................... 13
  112.           5) Product Codes ............................................. 14
  113.           6) Other Parameters .......................................... 14
  114.              - Environment ............................................. 14
  115.              - Check Bad Message Board ................................. 14
  116.              - ARCmail 0.6 Compatibility ............................... 15
  117.              - Number of Dupe Records .................................. 15
  118.              - Auto-add ................................................ 15
  119.              - Max Packet Size (R) ..................................... 16
  120.              - Swap Options ............................................ 16
  121.              - Truncate/Delete Sent ARCmail ............................ 16
  122.              - Single Bundle Extract (R) ............................... 17
  123.              - Send Return Receipt (R) ................................. 17
  124.              - Forward For (R) ......................................... 17
  125.              - Automatic Message Replies (R) ........................... 18
  126.              - Sysop Name .............................................. 18
  127.  
  128.     ════════════════════════════════════════════════════════════════════════
  129.     (C) Fabiano Fabris 1990, 1991                                     Page i
  130.     ════════════════════════════════════════════════════════════════════════
  131.  
  132.     ════════════════════════════════════════════════════════════════════════
  133.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  134.     ════════════════════════════════════════════════════════════════════════
  135.  
  136.  
  137.        b. Compression Programs ......................................... 18
  138.        c. Decompression Programs ....................................... 19
  139.        d. Echo Areas ................................................... 19
  140.           1) Editing Keys .............................................. 19
  141.              - F1: Edit ................................................ 20
  142.              - F2: Find ................................................ 20
  143.              - F3: Global .............................................. 20
  144.              - F4: Browse .............................................. 20
  145.              - F10: Save ............................................... 21
  146.              - Ins: Add ................................................ 21
  147.              - Del: Delete ............................................. 21
  148.              - Home: First ............................................. 21
  149.              - End: Last ............................................... 21
  150.              - ESC: Exit ............................................... 21
  151.              - PgUp/PgDn: Previous/Next ................................ 21
  152.           2) The Echo Area Record ...................................... 22
  153.              - Area Name ............................................... 22
  154.              - Active .................................................. 22
  155.              - Comment ................................................. 22
  156.              - Origin Line ............................................. 22
  157.              - Board ................................................... 23
  158.              - Passthrough ............................................. 23
  159.              - Secure .................................................. 23
  160.              - # Days .................................................. 24
  161.              - Group ................................................... 24
  162.              - Tiny-Seens .............................................. 24
  163.              - Keep-Seens .............................................. 24
  164.              - # Msgs .................................................. 25
  165.              - Origin Address .......................................... 25
  166.              - Seen-Bys ................................................ 25
  167.              - Export List ............................................. 25
  168.        e. Node Export Manager .......................................... 26
  169.           1) Editing Keys .............................................. 26
  170.              - F1: Edit ................................................ 26
  171.              - F2: Find ................................................ 26
  172.              - F4: Browse .............................................. 26
  173.              - F10: Save ............................................... 26
  174.              - Ins: Add ................................................ 27
  175.              - Del: Delete ............................................. 27
  176.              - Home: First ............................................. 27
  177.              - End: Last ............................................... 27
  178.              - ESC: Exit ............................................... 27
  179.              - PgUp/PgDn: Previous/Next ................................ 27
  180.           2) Address ................................................... 27
  181.           3) Password .................................................. 27
  182.           4) Groups .................................................... 28
  183.           5) Direct .................................................... 28
  184.           6) Remote Maint (R) .......................................... 28
  185.           7) Status .................................................... 28
  186.           8) Program ................................................... 29
  187.           9) Capability ................................................ 29
  188.           10) Cap Handling ............................................. 29
  189.        f. Pack Routing ................................................. 30
  190.        g. Import/Export ................................................ 31
  191.           1) Import Areas.Bbs .......................................... 31
  192.  
  193.     ════════════════════════════════════════════════════════════════════════
  194.     (C) Fabiano Fabris 1990, 1991                                    Page ii
  195.     ════════════════════════════════════════════════════════════════════════
  196.  
  197.     ════════════════════════════════════════════════════════════════════════
  198.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  199.     ════════════════════════════════════════════════════════════════════════
  200.  
  201.  
  202.           2) Export Areas Config (R) ................................... 32
  203.           3) Create Areas.Bbs File ..................................... 32
  204.           4) Export Group List (R) ..................................... 32
  205.           5) Export Nodes Config (R) ................................... 33
  206.  
  207.     6. IMAIL COMMAND LINE OPTIONS ...................................... 34
  208.        a. /? - Help .................................................... 34
  209.        b. TOSS - Toss Incoming Mail .................................... 34
  210.           1) /B - Check Bad Message Board .............................. 35
  211.           2) /N - No AreaLink .......................................... 35
  212.           3) /R - No Autoreply ......................................... 35
  213.           4) /X - No Compression ....................................... 36
  214.        c. SCAN - Scan for Outgoing Mail ................................ 36
  215.           1) /F - Force Complete SCAN .................................. 36
  216.           2) /X - No Compression ....................................... 37
  217.        d. ALNK - AreaLink .............................................. 37
  218.  
  219.     7. IMPACK - Pack Net Mail Messages ................................. 38
  220.        a. /N - No Default Pack Routing ................................. 40
  221.        b. /C - Pack Crash Messages ..................................... 40
  222.        c. /D - Pack Direct Messages .................................... 40
  223.        d. /H - Pack Hold Messages ...................................... 40
  224.        e. /R - Pack Route Direct ....................................... 40
  225.        f. /? - Help .................................................... 41
  226.  
  227.     8. AREALINK ........................................................ 42
  228.        a. Format of the Request ........................................ 42
  229.        b. Meta-Commands ................................................ 43
  230.           1) %ALL ...................................................... 43
  231.           2) %FROM (R) ................................................. 43
  232.           3) %HELP ..................................................... 44
  233.           4) %LIST ..................................................... 44
  234.           5) %QUERY .................................................... 44
  235.           6) %RESCAN ................................................... 44
  236.           7) %UNLINKED ................................................. 45
  237.        c. AreaLink Replies ............................................. 45
  238.        d. Forward Link Requests (R) .................................... 45
  239.        e. Remote Deletion (R) .......................................... 45
  240.        f. Remote Change (R) ............................................ 46
  241.        g. Local Maintainance (R) ....................................... 47
  242.           1) /N<address> - Node to Make Changes For .................... 47
  243.           2) /+<area> - Link Node to Area .............................. 47
  244.           3) /-<area> - Unlink Node from Area .......................... 48
  245.           4) /L - List Available Areas ................................. 48
  246.           5) /Q - Query - List Linked Echos ............................ 48
  247.           6) /U - List Available but Unlinked Echos .................... 48
  248.           7) /R - Rescan ............................................... 48
  249.           8) /H - Send Help ............................................ 48
  250.           9) /D<area> - Delete Echo Area ............................... 48
  251.           10) /C<area:area> - Change Echo Name ......................... 48
  252.  
  253.     9. AUTOMATIC MESSAGE REPLIES (R) ................................... 49
  254.        a. %of% ......................................................... 49
  255.        b. %ol% ......................................................... 49
  256.        c. %os% ......................................................... 49
  257.  
  258.     ════════════════════════════════════════════════════════════════════════
  259.     (C) Fabiano Fabris 1990, 1991                                   Page iii
  260.     ════════════════════════════════════════════════════════════════════════
  261.  
  262.     ════════════════════════════════════════════════════════════════════════
  263.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  264.     ════════════════════════════════════════════════════════════════════════
  265.  
  266.  
  267.        d. %df% ......................................................... 49
  268.        e. %dl% ......................................................... 49
  269.        f. %ds% ......................................................... 49
  270.        g. %mt% ......................................................... 50
  271.        h. %md% ......................................................... 50
  272.        i. %at% ......................................................... 50
  273.        j. %ad% ......................................................... 50
  274.        k. %dy% ......................................................... 50
  275.        l. %im% ......................................................... 50
  276.  
  277.     10. IMTHINGS ....................................................... 51
  278.        a. IMPORT - Import Net Mail Messages ............................ 51
  279.        b. INDEX - Rebuild index files .................................. 51
  280.        c. KILL - Delete messages from an area .......................... 52
  281.           1) /A<areaname> .............................................. 52
  282.           2) /B<board> ................................................. 52
  283.           3) /D<days> .................................................. 52
  284.           4) /K<days> (R) .............................................. 53
  285.           5) /N<number> ................................................ 53
  286.           6) /P - Run PACK after KILL .................................. 53
  287.           7) /U - Use Default Information .............................. 53
  288.        d. LINK - Link Messages in Message Base ......................... 54
  289.           1) /C - Clean ................................................ 54
  290.        e. MOVE - Move Message Area ..................................... 54
  291.           1) /R<src area> .............................................. 54
  292.           2) /S<src board> ............................................. 55
  293.           3) /T<dst area> .............................................. 55
  294.           4) /D<dst board> ............................................. 55
  295.        f. NOLINK ....................................................... 55
  296.           1) /D - Mark as Deleted ...................................... 55
  297.           2) /I - Mark as Inactive ..................................... 56
  298.           3) /P - Passthrough Only ..................................... 56
  299.        g. NOTIFY - Send list of linked echos ........................... 56
  300.           1) /A - List all available areas ............................. 56
  301.           2) /N - No node manager ...................................... 57
  302.           3) /P - Notify AreaLink Password ............................. 57
  303.        h. PACK - Compress message base ................................. 57
  304.           1) /B - Keep backup .......................................... 58
  305.           2) /R - Renumber ............................................. 58
  306.        i. POST - Post message in echo area ............................. 58
  307.           1) /F<filename> .............................................. 58
  308.           2) /A<areaname> .............................................. 58
  309.           3) /B<board> ................................................. 58
  310.           4) /W<to_who> ................................................ 59
  311.           5) /R<from_who> .............................................. 59
  312.           6) /S<subject> ............................................... 59
  313.        j. RECOVER (R) - Unerase messages ............................... 59
  314.           1) /A<areaname> .............................................. 59
  315.           2) /B<board> ................................................. 60
  316.           3) /U - Automatic Mode ....................................... 60
  317.        k. SEND (R) - Send a file ....................................... 60
  318.           1) /F<filename> .............................................. 60
  319.           2) /A<address> ............................................... 61
  320.           3) /W<to_who> ................................................ 61
  321.           4) /T<text> .................................................. 61
  322.  
  323.     ════════════════════════════════════════════════════════════════════════
  324.     (C) Fabiano Fabris 1990, 1991                                    Page iv
  325.     ════════════════════════════════════════════════════════════════════════
  326.  
  327.     ════════════════════════════════════════════════════════════════════════
  328.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  329.     ════════════════════════════════════════════════════════════════════════
  330.  
  331.  
  332.           5) /C - Crash ................................................ 61
  333.           6) /H - Hold ................................................. 61
  334.           7) /D - Direct ............................................... 61
  335.           8) /K - Kill/Sent ............................................ 62
  336.           9) /E - Delete/Sent .......................................... 62
  337.           10) /Y<days> - Newer than .................................... 62
  338.           11) /N<1-16> - Alternate AKA ................................. 62
  339.        l. SORT - Sort the Message Base ................................. 62
  340.           1) /Q - "Quick" Sort ......................................... 63
  341.        m. STAT - Generate Statistics Report ............................ 63
  342.           1) /C - Use only low ASCII ................................... 63
  343.           2) /E - Show Empty Areas Also ................................ 63
  344.           3) /F - Echo Stat Log File ................................... 64
  345.           4) /G - Groups ............................................... 64
  346.           5) /K - Keep Statistics Information .......................... 64
  347.           6) /B - Sort by Board number ................................. 64
  348.           7) /R - Sort by Group ........................................ 64
  349.           8) /N - Sort by Area Name .................................... 64
  350.  
  351.     11. AN OVERVIEW OF ECHOMAIL ........................................ 65
  352.        a. What is Echo Mail? ........................................... 65
  353.        b. How it Works ................................................. 65
  354.        c. Echo Mail Message Control Information ........................ 65
  355.           1) Area Line ................................................. 66
  356.           2) Tear Line ................................................. 66
  357.           3) Origin Line ............................................... 66
  358.           4) SEEN-BY Lines ............................................. 67
  359.           5) PATH Lines ................................................ 67
  360.        d. Methods of Sending Echo Mail ................................. 67
  361.        e. Topology ..................................................... 68
  362.        f. Why a PATH line? ............................................. 69
  363.        g. Gating of Echo Mail .......................................... 70
  364.  
  365.     12. KLUDGE LINES USED BY IMAIL ..................................... 71
  366.        a. EID .......................................................... 71
  367.        b. FLAGS ........................................................ 71
  368.           1) DIR ....................................................... 71
  369.           2) IMM ....................................................... 71
  370.           3) TFS ....................................................... 72
  371.           4) KFS ....................................................... 72
  372.           5) CFM ....................................................... 72
  373.           6) RRQ ....................................................... 72
  374.        c. FMPT ......................................................... 72
  375.        d. INTL ......................................................... 73
  376.        e. MSGID ........................................................ 73
  377.        f. PID .......................................................... 73
  378.        g. REPLY ........................................................ 74
  379.        h. RESCANNED .................................................... 74
  380.        i. TOPT ......................................................... 74
  381.  
  382.     13. BATCH FILE EXAMPLE ............................................. 75
  383.  
  384.     14. MISCELLANEOUS INFORMATION ...................................... 77
  385.        a. A Note about Capability ...................................... 77
  386.        b. Files Maintained by IMAIL .................................... 78
  387.  
  388.     ════════════════════════════════════════════════════════════════════════
  389.     (C) Fabiano Fabris 1990, 1991                                     Page v
  390.     ════════════════════════════════════════════════════════════════════════
  391.  
  392.     ════════════════════════════════════════════════════════════════════════
  393.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  394.     ════════════════════════════════════════════════════════════════════════
  395.  
  396.  
  397.        c. Exit Codes ................................................... 78
  398.  
  399.     15. IMAIL DISTRIBUTION SITES ....................................... 80
  400.        a. Registration Sites ........................................... 80
  401.           1) Headquarters .............................................. 80
  402.           2) Australia ................................................. 80
  403.           3) Austria ................................................... 80
  404.           4) Europe .................................................... 80
  405.           5) Germany ................................................... 81
  406.           6) United Kingdom ............................................ 81
  407.           7) North America ............................................. 81
  408.              - IMAIL Support & Distribution N.A. #1 .................... 81
  409.              - IMAIL Support & Distribution N.A. #2 .................... 81
  410.        b. Support Sites ................................................ 81
  411.           1) France .................................................... 81
  412.           2) Spain ..................................................... 81
  413.           3) Sweden .................................................... 82
  414.           4) Switzerland ............................................... 82
  415.           5) U.S.A. .................................................... 82
  416.  
  417.     16. P.S. ........................................................... 83
  418.  
  419.  
  420.                ═════════════════════════════════════════════════
  421.  
  422.  
  423.         INDEX .......................................................... 84
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.     ════════════════════════════════════════════════════════════════════════
  454.     (C) Fabiano Fabris 1990, 1991                                    Page vi
  455.     ════════════════════════════════════════════════════════════════════════
  456.  
  457.     ════════════════════════════════════════════════════════════════════════
  458.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  459.     ════════════════════════════════════════════════════════════════════════
  460.  
  461.  
  462.      1. INTRODUCTION
  463.  
  464.         IMAIL is a FTSC-compatible echo mail processor and net mail message
  465.         bundler written for QuickBBS  or RemoteAccess and fully  compatible
  466.         BBS software. It can be used with mailers which implement the  file
  467.         attach method of mail transfer (such as FrontDoor), or with systems
  468.         which use "flow files" (such as Binkley).
  469.  
  470.         It also features full Zone and Point support, eliminating the  need
  471.         to use the "fake address" method of sending mail to and from points
  472.         (IMAIL does however have limited support for point net addressing).
  473.  
  474.         If you  are new  to  FidoNet-type mail  processing, I  suggest  you
  475.         familiarize yourself with the documentation for the mailer you will
  476.         be using, and read "An Overview of Echomail", Chapter 11.
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.     ════════════════════════════════════════════════════════════════════════
  519.     (C) Fabiano Fabris 1990, 1991                                     Page 1
  520.     ════════════════════════════════════════════════════════════════════════
  521.  
  522.     ════════════════════════════════════════════════════════════════════════
  523.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  524.     ════════════════════════════════════════════════════════════════════════
  525.  
  526.  
  527.      2. WARRANTY AND REGISTRATION INFORMATION
  528.  
  529.         IMAIL is distributed as ShareWare. This means that you are free  to
  530.         distribute this program to  anyone you like, as  long as you  don't
  531.         charge for it, modify the program in  any way, or add files to  the
  532.         original distribution archives.
  533.  
  534.         IMAIL may be used freely without registration in non-commercial and
  535.         non-governmental sites.  Commercial  and  governmental  sites  MUST
  536.         register the program if they  intend to continue using the  program
  537.         after a trial period of THIRTY (30) days.
  538.  
  539.         Registration is valid  for all  versions of the  program; you  only
  540.         need to  register once.  It will  enable the  advanced features  of
  541.         IMAIL, and give  me incentive  to continue  development... so  that
  542.         little feature you suggested can be implemented!  :-)
  543.  
  544.         The base  registration  cost  is $50.00  US.  For  specific  rates,
  545.         contact the  registration site  closest to  you, the  addresses  of
  546.         which appear in Chapter  15. Section a. When  you register, send  a
  547.         cheque or money  order to  the registration  site, and  a net  mail
  548.         message with your name  as it appears in  the IMSETUP screen,  your
  549.         postal address, and one of the network addresses you have  defined.
  550.         This is important, because  the key you receive  will be locked  on
  551.         your name and the network address you supply.
  552.  
  553.         When the registration fee is received, you shall be sent a net mail
  554.         message to which  your key will  be attached. The  name of the  key
  555.         file you will  receive will resemble  154BD7A9.KEY; rename this  to
  556.         IMAIL.KEY and copy it to the directory from which you run IMAIL, or
  557.         to the directory pointed to by the IMAIL environment variable. This
  558.         will enable the advanced features of  IMAIL. The key will be  valid
  559.         for all versions of IMAIL, future and past.
  560.  
  561.         IMAIL is in  no way a  crippled program, nor  will it stop  working
  562.         after a  certain amount  of time.  I didn't  like this  concept  in
  563.         ShareWare  programs.   So  instead,   some  extra   features   were
  564.         implemented which  would  only work  in  registered copies  of  the
  565.         program.
  566.  
  567.         This program  is only  guaranteed to  take up  disk space,  nothing
  568.         else. In other words, if it  breaks itself or your system, you  own
  569.         both parts. However, I will do  my utmost to fix any bugs  reported
  570.         to me, ask long as  I have enough information to  do so. Due to  my
  571.         work load, I can only guarantee support to registered users.
  572.  
  573.         Bug reports and comments should be addressed to:
  574.  
  575.            Fabiano Fabris
  576.            Via Zardini 19
  577.            33090 Sequals (PN)
  578.            Italy
  579.  
  580.            FidoNet   2:230/41.22
  581.            intlnet   57:57/0
  582.  
  583.     ════════════════════════════════════════════════════════════════════════
  584.     (C) Fabiano Fabris 1990, 1991                                     Page 2
  585.     ════════════════════════════════════════════════════════════════════════
  586.  
  587.     ════════════════════════════════════════════════════════════════════════
  588.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  589.     ════════════════════════════════════════════════════════════════════════
  590.  
  591.  
  592.         a. Standard Disclaimer
  593.  
  594.            This  product  is  meant  for  educational  purposes  only.  Any
  595.            resemblance  to  real   persons,  living  or   dead  is   purely
  596.            coincidental. Void  where  prohibited. Some  assembly  required.
  597.            List  each  check  separately  by  bank  number.  Batteries  not
  598.            included. Contents  may  settle  during shipment.  Use  only  as
  599.            directed. No other  warranty expressed  or implied.  Do not  use
  600.            while operating a motor vehicle or heavy equipment. Postage will
  601.            be paid by addressee.  Subject to CAB approval.  This is not  an
  602.            offer to sell securities.  Apply only to  affected area. May  be
  603.            too intense for some viewers. Do  not stamp. Use other side  for
  604.            additional listings. For recreational use only. Do not  disturb.
  605.            All models over 18 years of age. If condition persists,  consult
  606.            your physician. No  user-serviceable parts  inside. Freshest  if
  607.            eaten before date on carton.  Subject to change without  notice.
  608.            Times approximate. Simulated  picture. No  postage necessary  if
  609.            mailed in  Antartica. Breaking  seal constitutes  acceptance  of
  610.            agreement. For off-road use only. As  seen on TV. One size  fits
  611.            all. Many suitcases look alike. Contains a substantial amount of
  612.            non-tobacco ingredients.  Colours may,  in time,  fade. We  have
  613.            sent the forms  which seem to  be right for  you. Slippery  when
  614.            wet. For office  use only.  Not affiliated with  the Red  Cross.
  615.            Drop in any mailbox. Edited  for television. Keep cool;  process
  616.            promptly. Post office will not deliver without postage. List was
  617.            current at time  of printing.  Return to  sender, no  forwarding
  618.            order on file,  unable to forward.  Not responsible for  direct,
  619.            indirect, incidental or consequential damages resulting from any
  620.            defect, error or failure to perform. At participating  locations
  621.            only.  Not the Beatles. Penalty for  private use. See label  for
  622.            sequence. Substantial penalty for early withdrawal. Do not write
  623.            below this line.  Falling rock.  Lost ticket pays maximum  rate.
  624.            Your cancelled check  is your  receipt. Add  toner. Place  stamp
  625.            here. Avoid contact with skin. Sanitized for your protection. Be
  626.            sure each item is properly endorsed. Sign here without admitting
  627.            guilt. Employees and their families are not eligible. Beware  of
  628.            dog. Contestants have been briefed on some questions before  the
  629.            show. Limited time  offer, call now  to insure prompt  delivery.
  630.            You must  be  present  to  win.  No  passes  accepted  for  this
  631.            engagement. No purchase necessary. Processed at location stamped
  632.            in code at top  of carton. Shading within  a garment may  occur.
  633.            Use only in well-ventilated area. Keep away from fire or  flame.
  634.            Replace with same type. Approved for veterans. Booths for two or
  635.            more. Check  here if  tax deductible.  Some equipment  shown  is
  636.            optional. Price  does not  include  taxes. Not  recommended  for
  637.            children. Prerecorded for this time zone. Reproduction  strictly
  638.            prohibited. No  solicitors.  No  alcohol, dogs,  or  horses.  No
  639.            anchovies unless  otherwise specified.  Restaurant package,  not
  640.            for resale. List at  least two alternate  dates. First pull  up,
  641.            then pull down. Call toll  free before digging. Driver does  not
  642.            carry cash. Some  of the  trademarks mentioned  in this  product
  643.            appear  for  identification  purposes  only.  Record  additional
  644.            transactions on back of previous stub.
  645.  
  646.            This supersedes all previous notices.
  647.  
  648.     ════════════════════════════════════════════════════════════════════════
  649.     (C) Fabiano Fabris 1990, 1991                                     Page 3
  650.     ════════════════════════════════════════════════════════════════════════
  651.  
  652.     ════════════════════════════════════════════════════════════════════════
  653.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  654.     ════════════════════════════════════════════════════════════════════════
  655.  
  656.  
  657.      3. ACKNOWLEDGEMENTS
  658.  
  659.         This program is dedicated to Marco Manzocco, my very close  friend,
  660.         without whose support IMAIL would never have been written.
  661.  
  662.         My deepest gratitude to  my Beta Testers,  who risked seeing  their
  663.         message base grunged  by my  program, and for  having had  patience
  664.         when I released buggy beta  versions (a few horrible examples  come
  665.         to mind). I could never have done it without them!
  666.  
  667.         Very special thanks to:
  668.  
  669.            Henk  Heidema,   Jimmy  Hansen,   Roelof  Heuvel,   Joaquim   H.
  670.            Homrighausen, Mark Howard, Andreas Klein, Konrad Knauer, Maurice
  671.            Leeflang, Andreas  Levenitschnig, Luca  Leone, Jim  Louvau,  Tom
  672.            McGivern, Klaus Michael Ruebsam.
  673.  
  674.         IMSETUP makes use of  the C eXtended Library  (CXL) version 5.2  by
  675.         Mike Smedley.
  676.  
  677.  
  678.         a. Copyrights
  679.  
  680.            These  programs  are  mentioned   in  this  document,  and   are
  681.            copyrighted as follows:
  682.  
  683.               Binkley                       Bit Bucket Software Co
  684.               D'Bridge                      Chris Irwin
  685.               FrontDoor                     Joaquim Homrighausen
  686.               oMMM                          Wymm Wagner III
  687.               QuickBBS                      Richard Creighton &
  688.                                             Steve Grabilowitz
  689.               RemoteAccess                  Andrew Milner
  690.               Scottex Toilet Paper          Scott Corp.
  691.               TosScan                       Joaquim Homrighausen
  692.               XRS                           Mike Ratledge
  693.  
  694.            If I have forgotten someone, or have made any mistakes, my  most
  695.            sincere apologies! Drop  me a line  and I will  rectify for  the
  696.            next release.
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.     ════════════════════════════════════════════════════════════════════════
  714.     (C) Fabiano Fabris 1990, 1991                                     Page 4
  715.     ════════════════════════════════════════════════════════════════════════
  716.  
  717.     ════════════════════════════════════════════════════════════════════════
  718.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  719.     ════════════════════════════════════════════════════════════════════════
  720.  
  721.  
  722.      4. INSTALLATION
  723.  
  724.         IMAIL is supplied in a single compressed file which should  contain
  725.         the following files:
  726.  
  727.            IMAIL.EXE            The executable file
  728.  
  729.            IMPACK.EXE           The net mail packer program
  730.  
  731.            IMSETUP.EXE          The setup program
  732.  
  733.            IMTHINGS.EXE         The external utilities
  734.  
  735.            IMAIL.DOC            The documentation
  736.  
  737.            IMAIL.Q&A            Commonly asked questions, and answers
  738.  
  739.            CHANGES.DOC          Changes since the last release
  740.  
  741.            IM_REPLY.TXT         Sample text to use with the Automatic
  742.                                 reply function
  743.  
  744.            REGISTER.FRM         A registration form  which may be  imported
  745.                                 into a net mail message
  746.  
  747.         Copy the executable files to the same directory (which might be the
  748.         same directory from which you run QuickBBS or RemoteAccess) and run
  749.         IMSETUP.
  750.  
  751.  
  752.         a. Environment Variables
  753.  
  754.  
  755.            1) IMAIL
  756.  
  757.               Should you want IMAIL to look for its configuration files  in
  758.               another subdirectory, set the  environment variable IMAIL  to
  759.               point to it. For example:
  760.  
  761.                  SET IMAIL=C:\IMAIL
  762.  
  763.               Please note that IMAIL and its companion programs do not make
  764.               use of  any  other  program's configuration  files;  so,  for
  765.               example, message status  is specified in  the Node Manager  -
  766.               the mailer's route file is not used.
  767.  
  768.  
  769.            2) POINTNET
  770.  
  771.               If you  are a  "boss" node  and have  point running  software
  772.               which cannot  handle 4D  addressing, you  will have  assigned
  773.               them a point  net (sometimes called  a fakenet) address.  You
  774.               should inform IMAIL of this point net by setting the POINTNET
  775.  
  776.  
  777.  
  778.     ════════════════════════════════════════════════════════════════════════
  779.     (C) Fabiano Fabris 1990, 1991                                     Page 5
  780.     ════════════════════════════════════════════════════════════════════════
  781.  
  782.     ════════════════════════════════════════════════════════════════════════
  783.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  784.     ════════════════════════════════════════════════════════════════════════
  785.  
  786.  
  787.               environment variable, so that TOSS  and SCAN can then  remove
  788.               addresses contining the point net  from the SEEN-BYs in  echo
  789.               mail messages.
  790.  
  791.               For example, if  you were  using a  point net  of 31339,  you
  792.               would set the POINTNET variable with:
  793.  
  794.                  SET POINTNET=31339
  795.  
  796.  
  797.         b. System Requirements
  798.  
  799.  
  800.            1) Hardware
  801.  
  802.               IBM PC/AT/386, or fully compatible
  803.               Mono or color display
  804.               Hard disk
  805.  
  806.  
  807.            2) Software
  808.  
  809.               MS-DOS (or PC-DOS) 3.10 or greater
  810.               A message editor which supports the QuickBBS message format
  811.               An FTSC-0001 compatible  mailer
  812.               One or more compression programs, selected from:
  813.  
  814.                  ARC by System Enhancement Associates;
  815.                  Arj by Robert K. Jung
  816.                  LHarc by Haruyasu Yoshizaki;
  817.                  PKARC/PKPAK by PKWARE Inc.;
  818.                  PAK by NoGate Consulting;
  819.                  PKZip by PKWARE Inc.;
  820.                  ZOO by Rhaul Dhesi.
  821.  
  822.  
  823.            3) Networks & File Sharing
  824.  
  825.               IMAIL implements file sharing as "expected" by  RemoteAccess.
  826.               What this means  is that it  will open all  files in  sharing
  827.               mode, and will lock MSGINFO.BBS just before writing to any of
  828.               the message base files.
  829.  
  830.               Note that SHARE.EXE  =must= be  loaded in order  for this  to
  831.               work correctly!
  832.  
  833.               However, IMTHINGS does =not= make use of file sharing. It  is
  834.               expected that message base utilities will not be run while  a
  835.               user is on line, or while some other program is making use of
  836.               the message  base.  Damage  can  result if  you  try  to  use
  837.               IMTHINGS together with another program.
  838.  
  839.               WARNING!!!  This version of  IMAIL has not  been tested  with
  840.               any networking  software!  If you  run  Novell or  any  other
  841.               network, you do so at your own risk!
  842.  
  843.     ════════════════════════════════════════════════════════════════════════
  844.     (C) Fabiano Fabris 1990, 1991                                     Page 6
  845.     ════════════════════════════════════════════════════════════════════════
  846.  
  847.     ════════════════════════════════════════════════════════════════════════
  848.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  849.     ════════════════════════════════════════════════════════════════════════
  850.  
  851.  
  852.         c. Upgrading from Previous Versions
  853.  
  854.            If you are upgrading IMAIL  from a previous version, please  see
  855.            the file CHANGES.DOC for information  on new features since  the
  856.            last public release.
  857.  
  858.            If upgrading from 1.00 or 1.10 and have the full IMAIL  archive,
  859.            before using  any  of  the  other programs,  run  IMCVT  in  the
  860.            directory in which  the IMAIL configuration  files are  located.
  861.            This will upgrade you to 1.20. Once the conversion is  complete,
  862.            run IMSETUP (which  will upgrade you  to 1.21) and  go into  the
  863.            Area Manager.  Make  any changes  you  wish and  then  exit  the
  864.            manager. This will regenerate  the IMAIL.AX (Areas Index)  file,
  865.            which IMCVT does not do.
  866.  
  867.            If upgrading from 1.20, IMCVT is not required. Run IMSETUP,  and
  868.            then exit it. This will save the default list of Type 2+ product
  869.            codes.
  870.  
  871.            Note that since version 1.20,  the PACK function which was  once
  872.            part of IMAIL.EXE  has been  "exported" as  a separate  program,
  873.            called IMPACK.EXE; you will need  to modify your batch files  to
  874.            reflect this.
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.     ════════════════════════════════════════════════════════════════════════
  909.     (C) Fabiano Fabris 1990, 1991                                     Page 7
  910.     ════════════════════════════════════════════════════════════════════════
  911.  
  912.     ════════════════════════════════════════════════════════════════════════
  913.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  914.     ════════════════════════════════════════════════════════════════════════
  915.  
  916.  
  917.      5. IMSETUP
  918.  
  919.         The program IMSETUP is used  to configure the various options  used
  920.         by IMAIL. Some of these may be omitted, and some are available only
  921.         to registered users.
  922.  
  923.         In this chapter, each  option will be  examined in detail.  Options
  924.         available only to registered users are indicated with an (R).
  925.  
  926.         IMSETUP can be  given one  or more command  line options,  selected
  927.         from the following:
  928.  
  929.            /M    Force 'mono' color set
  930.            /C    Force 'color' color set
  931.            /D    Force direct screen writes
  932.            /S    Force CGA snow elimination
  933.  
  934.         Naturally, /D and /S have exactly opposite effects, so it makes  no
  935.         sense to use them together.
  936.  
  937.         Note: Should  you  wish  IMSETUP  to create  and/or  look  for  the
  938.         configuration files in a directory which is different from the  one
  939.         in which you ran it, set the IMAIL environment variable to point to
  940.         this directory.  Otherwise, IMSETUP  will create  in files  in  the
  941.         current working directory.
  942.  
  943.  
  944.         a. General Configuration
  945.  
  946.            This  options  leads  to  another  menu  which  allows   various
  947.            system-wide parameters  to  be  set. Please  read  this  section
  948.            carefully!
  949.  
  950.  
  951.            1) System Addresses
  952.  
  953.               The "System Addresses"  menu allows  you to define  up to  16
  954.               network addresses  and  net mail  boards.  The first  of  the
  955.               addresses is known as your primary address. It should be  the
  956.               same as the one defined as your primary in your mailer and/or
  957.               BBS program.
  958.  
  959.               The  other  addresses  given  are  your  system's  AKAs   (or
  960.               aliases).
  961.  
  962.               Addresses should be given in the form:
  963.  
  964.                  zone:net/node.point
  965.  
  966.               Addresses may be  in different zones,  and even in  different
  967.               domains (or networks). At least  the primary address must  be
  968.               specified.
  969.  
  970.  
  971.  
  972.  
  973.     ════════════════════════════════════════════════════════════════════════
  974.     (C) Fabiano Fabris 1990, 1991                                     Page 8
  975.     ════════════════════════════════════════════════════════════════════════
  976.  
  977.     ════════════════════════════════════════════════════════════════════════
  978.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  979.     ════════════════════════════════════════════════════════════════════════
  980.  
  981.  
  982.               Note that if you make changes to the list of addresses in  an
  983.               existing configuration, it is  advisable that you then  enter
  984.               the Area Manger to check  your Origin and SEEN-BY  addresses.
  985.               The Area Manager itself will attempt to "synchronize"  itself
  986.               with the changes you  made, but it  is likely that  something
  987.               will need to be checked.
  988.  
  989.               Beside each system address there is  an entry for a net  mail
  990.               board. Each of these refers to a board number in your message
  991.               base, which is used for your net mail messages.
  992.  
  993.               IMAIL will allow  you to define  a board number  for each  of
  994.               your AKAs. If any of the board numbers is underfined (set  to
  995.               0), the  the  board  number  corresponding  to  your  primary
  996.               address will be used.
  997.  
  998.  
  999.            2) Domain Names
  1000.  
  1001.               In this menu are specified the domain(s) to which you belong.
  1002.               The word "domain"  is used to  distinguish between  different
  1003.               amateur networks such as SIGnet and FidoNet.
  1004.  
  1005.               Here, you  should  indicate  the zone  number(s)  and  domain
  1006.               name(s) of which you  are a part. If  this is the first  time
  1007.               you are running it, IMSETUP will supply as default the  zones
  1008.               and domain names for SIGnet and FidoNet. You need not  define
  1009.               all the zones for a given domain, just those relevant to your
  1010.               geographical area.
  1011.  
  1012.               IMAIL uses this information for MSGID kludges when generating
  1013.               net mail messages (AreaLink or the AutoReply feature).
  1014.  
  1015.               If you are  in doubt of  which zone you  belong to, or  which
  1016.               domain, please contact your nearest Coordinator or Host.
  1017.  
  1018.  
  1019.            3) Subdirectories
  1020.  
  1021.               In this menu, specify  the paths to  the various files  IMAIL
  1022.               needs to  use  during  execution.  Most  of  the  fields  are
  1023.               required.
  1024.  
  1025.               When specifying  subdirectories, you  may omit  the  trailing
  1026.               backslash.
  1027.  
  1028.  
  1029.               - QBBS/RA System
  1030.  
  1031.                 Specify the path  to the QuickBBS  or RemoteAccess  message
  1032.                 base files.  These  message  base files  are  searched  for
  1033.                 outgoing messages when you run the IMAIL SCAN function. For
  1034.                 example:
  1035.  
  1036.                    C:\QBBS
  1037.  
  1038.     ════════════════════════════════════════════════════════════════════════
  1039.     (C) Fabiano Fabris 1990, 1991                                     Page 9
  1040.     ════════════════════════════════════════════════════════════════════════
  1041.  
  1042.     ════════════════════════════════════════════════════════════════════════
  1043.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1044.     ════════════════════════════════════════════════════════════════════════
  1045.  
  1046.  
  1047.                 This field is required.
  1048.  
  1049.  
  1050.               - Net Mail Message
  1051.  
  1052.                 The path to where your  mailer stores its net mail  message
  1053.                 (*.MSG) files.  IMAIL  will  use this  when  searching  for
  1054.                 existant file  attaches,  when  creating  new  file  attach
  1055.                 messages, or when  it generates  outgoing net  mail of  its
  1056.                 own.
  1057.  
  1058.                 This field is required.
  1059.  
  1060.  
  1061.               - Inbound Net Files
  1062.  
  1063.                 This is where  your mailer stores  inbound compressed  mail
  1064.                 files and packets. IMAIL  will look here  when you run  the
  1065.                 TOSS function.
  1066.                 NOTE: Please do =not= run IMAIL from this directory!
  1067.  
  1068.                 This field is required.
  1069.  
  1070.  
  1071.               - Outbound Net Files
  1072.  
  1073.                 This subdirectory is where  your mailer normally looks  for
  1074.                 outbound compresses files. These files may be generated  by
  1075.                 all of IMAIL's functions.
  1076.  
  1077.                 This may NOT be  the same subdirectory  as the Inbound  Net
  1078.                 Files directory, otherwise IMAIL will process the files  as
  1079.                 if they were FOR your system.
  1080.  
  1081.                 Note that if you are running in a Binkley environment, this
  1082.                 will be the  subdirectory in which  outgoing mail for  your
  1083.                 PRIMARY zone will be placed. Mail addressed to other  zones
  1084.                 will be  placed in  other subdirectories,  having the  same
  1085.                 root name as the  one specified in this  field, but with  a
  1086.                 3-digit numeric extension. For  more details, please  refer
  1087.                 to the Binkley documentation.
  1088.  
  1089.                 This field is required.
  1090.  
  1091.  
  1092.               - IMAIL Log File Name
  1093.  
  1094.                 Is you wish  IMAIL to  log its  activity to  file, you  may
  1095.                 specify the name  of the log  file here. It  should be  the
  1096.                 complete path  and name  of  the file.  If  a path  is  not
  1097.                 specified, the file will be written to the current  working
  1098.                 directory.
  1099.  
  1100.  
  1101.  
  1102.  
  1103.     ════════════════════════════════════════════════════════════════════════
  1104.     (C) Fabiano Fabris 1990, 1991                                    Page 10
  1105.     ════════════════════════════════════════════════════════════════════════
  1106.  
  1107.     ════════════════════════════════════════════════════════════════════════
  1108.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1109.     ════════════════════════════════════════════════════════════════════════
  1110.  
  1111.  
  1112.               - Auto-Added Areas Log
  1113.  
  1114.                 If you have  enabled the Auto-Add  feature (see section  6)
  1115.                 below), you can have IMAIL  create a text file listing  the
  1116.                 echo areas it creates. This file will also be written to by
  1117.                 AreaLink if it creates any  new area records. Specify  just
  1118.                 the file name, with  no path; the file  will be written  to
  1119.                 the directory pointed to by the IMAIL environment variable.
  1120.  
  1121.  
  1122.               - Log Format
  1123.  
  1124.                 If you have specified that IMAIL should create a log  file,
  1125.                 here you may indicate how  much information you wish to  be
  1126.                 written to the log file.
  1127.  
  1128.                 There are four possible choices:
  1129.  
  1130.                    0: Normal.  This will  log only  important  information,
  1131.                    errors and final stats to the log.
  1132.  
  1133.                    1:  Verbose.  Complete   information  will  be   logged,
  1134.                    including all echo areas scanned or tossed.
  1135.  
  1136.                    2: FrontDoor.  This will  create a  log file  compatible
  1137.                    with  the  format  used  by  FrontDoor.  The  amount  of
  1138.                    information  written,  however,  is  the  same  as   for
  1139.                    "Normal"
  1140.  
  1141.                    3: Binkley. This will create a log file compatible  with
  1142.                    the format used  by Binkley. The  amount of  information
  1143.                    written is the same as for "Normal".
  1144.  
  1145.  
  1146.               - Bad Message Board
  1147.  
  1148.                 Messages flagged as "bad" will be tossed into this  message
  1149.                 board. These  include  echo  mail  messages  arriving  from
  1150.                 unlisted systems  when "Secure"  mode  is active  for  that
  1151.                 area, as well as  echo in unrecognized  echos. If you  have
  1152.                 enabled Auto-Adding of new areas,  the mail will still  end
  1153.                 up in this board, until the new area record is edited.
  1154.  
  1155.                 This field is required.
  1156.  
  1157.                 Note: this board  should NOT  be used  for anything  except
  1158.                 "bad" mail! If you post messages into this board, there  is
  1159.                 a distinct possibility  that the messages  will be sent  to
  1160.                 other systems should any areas be automatically added.
  1161.  
  1162.  
  1163.               - Dupe Message Board
  1164.  
  1165.                 This message  board  is the  one  into which  all  messages
  1166.                 flagged as duplicates will be tossed. It may be the same as
  1167.  
  1168.     ════════════════════════════════════════════════════════════════════════
  1169.     (C) Fabiano Fabris 1990, 1991                                    Page 11
  1170.     ════════════════════════════════════════════════════════════════════════
  1171.  
  1172.     ════════════════════════════════════════════════════════════════════════
  1173.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1174.     ════════════════════════════════════════════════════════════════════════
  1175.  
  1176.  
  1177.                 the one  defined a  Bad  Message Board  (see above),  or  a
  1178.                 different board.  If  not  defined, dupes  will  simply  be
  1179.                 killed (deleted).
  1180.  
  1181.                 Note: This board  should not  be used  for anything  except
  1182.                 duplicate messages (or "bad" mail, if set to be the same as
  1183.                 the Bad Message Board).
  1184.  
  1185.  
  1186.               - Default Origin
  1187.  
  1188.                 This is  the Origin  Line which  will be  automatically  be
  1189.                 inserted in newly created area records by TOSS or AreaLink.
  1190.                 It will also be used in cases when an existing area  record
  1191.                 has no origin line defined. This field is required.
  1192.  
  1193.  
  1194.            4) AreaLink Options
  1195.  
  1196.               The options in this menu regard IMAIL's area manager,  called
  1197.               AREALINK. This function will do  for IMAIL what AreaFix  does
  1198.               for other systems.
  1199.  
  1200.               Your downlinks will be able to request that new areas be sent
  1201.               to them, or that areas no longer be sent. Besides this,  they
  1202.               may request information on which echos are available to them,
  1203.               and have a list of the echos they are currently receiving. In
  1204.               registered copies of IMAIL,  AreaLink can also request  areas
  1205.               not available on your system from your uplinks, thus  further
  1206.               automating your system.
  1207.  
  1208.               For information on how AreaLink is used, see Chapter 8.
  1209.  
  1210.  
  1211.               - Keep AreaLink Receipt
  1212.  
  1213.                 If you enable this option (set it to 'Y'), then IMAIL  will
  1214.                 not mark  its  outgoing  messages as  KILL/SENT.  In  other
  1215.                 words, once the message  has been sent,  it will remain  in
  1216.                 your net mail directory for you to see it.
  1217.  
  1218.  
  1219.               - Allow Rescan Request
  1220.  
  1221.                 If enabled,  AreaLink will  honour requests  to rescan  the
  1222.                 message base for a particular echo. For more information on
  1223.                 how the rescan may be requested, see Chapter 8. Section b.
  1224.  
  1225.                 If this  option is  set  to "N",  rescan requests  will  be
  1226.                 ignored.
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.     ════════════════════════════════════════════════════════════════════════
  1234.     (C) Fabiano Fabris 1990, 1991                                    Page 12
  1235.     ════════════════════════════════════════════════════════════════════════
  1236.  
  1237.     ════════════════════════════════════════════════════════════════════════
  1238.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1239.     ════════════════════════════════════════════════════════════════════════
  1240.  
  1241.  
  1242.               - AreaLink Help Text
  1243.  
  1244.                 In this field you  may specify the name  of a text file  to
  1245.                 send if a user requests help with AreaLink (see Chapter  8.
  1246.                 Section b.) If  no name  is specified,  then AreaLink  will
  1247.                 send a standard text.
  1248.  
  1249.                 If a file is specified, it must be located in the directory
  1250.                 pointed to by  the IMAIL  environment variable,  or in  the
  1251.                 directory which is current when IMAIL is run.
  1252.  
  1253.  
  1254.               - Forward Link Requests (R)
  1255.  
  1256.                 Forward  Link  Requests   are  a  method   to  have   IMAIL
  1257.                 automatically request  areas  from your  echo  uplinks.  If
  1258.                 AreaLink processes a request for an echo area which is  not
  1259.                 listed in your configuration, it will search the files  you
  1260.                 have defined  for  this area.  If  found, it  will  send  a
  1261.                 request for that area to the system listed. See Chapter  8.
  1262.                 section d. for more information.
  1263.  
  1264.                 In the "Uplink" column, specify the network address of  the
  1265.                 system to  which the  request should  be sent.  The  "Areas
  1266.                 file" column indicates the file  name of an AREAS.BBS  type
  1267.                 file containing the  list of echo  areas available on  that
  1268.                 system.
  1269.  
  1270.                 In the  "Areas  File"  column, indicate  the  name  of  the
  1271.                 AREAS.BBS-type file which AreaLink should search. This file
  1272.                 should be located in the directory pointed to by the  IMAIL
  1273.                 environment variable  (if set),  or in  the directory  from
  1274.                 which IMAIL is run if the IMAIL variable is not set.
  1275.                 The format of the AREAS.BBS file  is the same as that  used
  1276.                 by most programs, and recognized by the "Import  Areas.Bbs"
  1277.                 function in IMSETUP. Each line is composed of three fields.
  1278.                 The first is  a board  number or a  subdirectory name,  and
  1279.                 must be present in order for IMAIL to correctly extract the
  1280.                 information it needs. The second  field is the name of  the
  1281.                 echo area. The third field is the list of export addresses;
  1282.                 this field is  not required. Note  that IMAIL will  discard
  1283.                 the first line of the file, as well as any beginning with a
  1284.                 semi-colon (';').
  1285.  
  1286.                 The "Send to" column should contain the name of the program
  1287.                 to which the  net mail message  will be sent,  such as  for
  1288.                 example AREAFIX, AREAMGR  or IMAIL.  If you  are unsure  of
  1289.                 what to put here, contact  your uplink. Note that  AreaLink
  1290.                 will behave  a  bit  differently if  AREAFIX  is  specified
  1291.                 instead of another name.
  1292.  
  1293.                 The last  column, "Password",  indicates the  password  the
  1294.                 uplink has  assigned  to  your system.  You  will  need  to
  1295.                 contact your uplink to have one assigned to you.
  1296.  
  1297.  
  1298.     ════════════════════════════════════════════════════════════════════════
  1299.     (C) Fabiano Fabris 1990, 1991                                    Page 13
  1300.     ════════════════════════════════════════════════════════════════════════
  1301.  
  1302.     ════════════════════════════════════════════════════════════════════════
  1303.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1304.     ════════════════════════════════════════════════════════════════════════
  1305.  
  1306.  
  1307.            5) Product Codes
  1308.  
  1309.               This small and apparently  insignificant menu is really  very
  1310.               important. It allows  you to indicate  mail processors  which
  1311.               product Type 2+ information in  the packet header. (For  more
  1312.               information about this and  the Capability Word, see  Chapter
  1313.               14. Section a.)
  1314.  
  1315.               With this information, IMAIL TOSS will know how to  correctly
  1316.               process  incoming  mail.  If  it  finds  a  packet  with   no
  1317.               capability word,  it  will scan  the  list of  product  codes
  1318.               defined in this  menu to  see if the  packet really  contains
  1319.               zone and point information. If the packet was produced by one
  1320.               of the programs whose code is listed here, then it will treat
  1321.               the packet as it is was fully Type 2+. Otherwise, it will  be
  1322.               treated as "Stone Age".
  1323.  
  1324.               Up to  ten product  codes  may be  defined. When  first  run,
  1325.               IMSETUP will  show 4  codes by  default: those  for  D'Bridge
  1326.               (1A), TosScan (3F), QMail (29) and ZMailQ (35).
  1327.  
  1328.               Note that the product codes must be entered in hexadecimal.
  1329.  
  1330.  
  1331.            6) Other Parameters
  1332.  
  1333.               This menu is a "catch all" for various options which  control
  1334.               how IMAIL operates.
  1335.  
  1336.               Most of the options  available are of  the "on/off" type;  in
  1337.               other words, specifying 'Y' will enable the option, while 'N'
  1338.               will disable it.
  1339.  
  1340.  
  1341.               - Environment
  1342.  
  1343.                 This field  will  accept either  a  'B' or  an  'F',  which
  1344.                 indicate respectively Binkley or FrontDoor.
  1345.  
  1346.                 By selecting  Binkley, IMAIL  will create  "flow files"  in
  1347.                 your outbound directory,  containing lists  of files  which
  1348.                 the mailer should send.
  1349.  
  1350.                 If instead you select  FrontDoor, IMAIL will generate  file
  1351.                 attach messages. This method can be used for other  mailers
  1352.                 which use file attach messages rather than "flow files".
  1353.  
  1354.  
  1355.               - Check Bad Message Board
  1356.  
  1357.                 If this option is active, IMAIL will check the Bad  Message
  1358.                 Board for echo mail which might have been considered  "bad"
  1359.                 during the previous  run. If  found, the  messages will  be
  1360.                 moved into the correct echo mail board.
  1361.  
  1362.  
  1363.     ════════════════════════════════════════════════════════════════════════
  1364.     (C) Fabiano Fabris 1990, 1991                                    Page 14
  1365.     ════════════════════════════════════════════════════════════════════════
  1366.  
  1367.     ════════════════════════════════════════════════════════════════════════
  1368.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1369.     ════════════════════════════════════════════════════════════════════════
  1370.  
  1371.  
  1372.                 Use this option  if you  expect to receive  new echo  areas
  1373.                 without warning; once you have  added them to your list  of
  1374.                 areas, you can have IMAIL scan for the messages which would
  1375.                 otherwise "sit" in your Bad Message Board.
  1376.  
  1377.                 Please note that echo mail which is re-imported using  this
  1378.                 method cannot be exported. The reason for this is that  the
  1379.                 messages might easily create duplicates.
  1380.  
  1381.                 If you set this option off,  it may still be overridden  by
  1382.                 using the /B switch with IMAIL TOSS (see Chapter 6. section
  1383.                 b.).
  1384.  
  1385.  
  1386.               - ARCmail 0.6 Compatibility
  1387.  
  1388.                 If this option is set, IMAIL will generate compressed  mail
  1389.                 bundles that  conform to  the ARCmail  0.6 naming  standard
  1390.                 when sending  to  systems marked  in  the node  manager  as
  1391.                 "Stone Age", or to systems not listed in the node  manager.
  1392.                 Systems listed  as "Type  2+" will  have a  special  naming
  1393.                 scheme. (See Chapter 5. section  e. for information on  the
  1394.                 Capability Word).
  1395.  
  1396.                 If this is set to "No", then IMAIL will always use its  own
  1397.                 internal method  for  the  naming  of  outbound  compressed
  1398.                 files.
  1399.  
  1400.                 Note that the  setting of  this flag will  be ignored  when
  1401.                 IMAIL generates ARCmail to point addresses.
  1402.  
  1403.  
  1404.               - Number of Dupe Records
  1405.  
  1406.                 This field indicates how many dupe records IMAIL will  save
  1407.                 in the file IMAIL.DP for dupe checking. This number  should
  1408.                 not be set too high, since IMAIL reads the entire file into
  1409.                 memory to speed its searches. Instead, if the number is set
  1410.                 to zero, no dupe checking will be performed; this will make
  1411.                 IMAIL faster, but certainly less secure.
  1412.  
  1413.  
  1414.               - Auto-add
  1415.  
  1416.                 Enable this if you want IMAIL to automatically create a new
  1417.                 area record whenever  an echo  mail message  arrives in  an
  1418.                 undefined area. The area record  created will be marked  as
  1419.                 Auto-Added; the  node  which  originated  the  message  (or
  1420.                 better, your uplink)  will be inserted  in the export  list
  1421.                 for the new area.  No group will be  assigned, so the  area
  1422.                 will not be  available for request  by other systems  until
  1423.                 you edit the record.
  1424.  
  1425.  
  1426.  
  1427.  
  1428.     ════════════════════════════════════════════════════════════════════════
  1429.     (C) Fabiano Fabris 1990, 1991                                    Page 15
  1430.     ════════════════════════════════════════════════════════════════════════
  1431.  
  1432.     ════════════════════════════════════════════════════════════════════════
  1433.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1434.     ════════════════════════════════════════════════════════════════════════
  1435.  
  1436.  
  1437.                 Any other messages  which arrive  in the new  area will  be
  1438.                 tossed into your bad message  board, until you have  edited
  1439.                 the  new  area  to  assign  it  a  board,  or  to  make  it
  1440.                 passthrough. This  way  you  will  not  loose  any  of  the
  1441.                 messages arriving in the new area.
  1442.  
  1443.                 Note that this flag does not affect auto-adding of areas by
  1444.                 AreaLink (see Chapter 8. section  d.), which are marked  as
  1445.                 passthrough, so the  messages will not  be tossed into  the
  1446.                 bad message board.
  1447.  
  1448.  
  1449.               - Max Packet Size (R)
  1450.  
  1451.                 With this option, you can  specify the maximum size of  the
  1452.                 packet files (*.PKT)  that IMAIL will  create. Use this  if
  1453.                 your up- and/or down links are short on disk space.
  1454.  
  1455.                 The number should indicate a  size in kilobytes. If a  zero
  1456.                 (0) is specified, there will be no limit imposed.
  1457.  
  1458.  
  1459.               - Swap Options
  1460.  
  1461.                 Before  calling  any  external  programs  (compression   or
  1462.                 decompression programs), IMAIL will swap most of itself out
  1463.                 of memory, to leave room  for the program called. Once  the
  1464.                 program has completed, IMAIL  will be reloaded into  memory
  1465.                 and continue execution.
  1466.  
  1467.                    E - EMS. If you specify EMS, IMAIL will try to  allocate
  1468.                    a certain  number of  EMS pages  to try  to swap  itself
  1469.                    into. If this fails, it will swap to disk
  1470.  
  1471.                    X - Extended memory. If  you specify this option,  IMAIL
  1472.                    will try to swap to  extended memory. If this fails,  it
  1473.                    will swap to disk. (Note: Extended memory here refers to
  1474.                    XMS; in  other words,  you will  need a  driver such  as
  1475.                    HIMEM.SYS in order for it to work.)
  1476.  
  1477.                    B - Both. This indicates that IMAIL should try both  EMS
  1478.                    and extended  memory,  in  that  order.  If  both  fail,
  1479.                    swapping to disk will occur.
  1480.  
  1481.                    D - Disk. IMAIL  will swap its  overlay buffers to  disk
  1482.                    when needed. This is the  default, and also the  slowest
  1483.                    of the options.
  1484.  
  1485.  
  1486.               - Truncate/Delete Sent ARCmail
  1487.  
  1488.                 Normally, when ARCmail  has been sent  by your mailer,  the
  1489.                 file is truncated  (that is,  its length is  set to  zero).
  1490.                 This allows  IMAIL  to  generate  a new  file  name  if  it
  1491.                 processes more outbound mail for the same system.
  1492.  
  1493.     ════════════════════════════════════════════════════════════════════════
  1494.     (C) Fabiano Fabris 1990, 1991                                    Page 16
  1495.     ════════════════════════════════════════════════════════════════════════
  1496.  
  1497.     ════════════════════════════════════════════════════════════════════════
  1498.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1499.     ════════════════════════════════════════════════════════════════════════
  1500.  
  1501.  
  1502.                 If for any reason  you want the mailer  to delete the  file
  1503.                 instead of truncating it, set this option to 'D'.  However,
  1504.                 it is NOT suggested that this be done! Use this option with
  1505.                 caution!
  1506.  
  1507.  
  1508.               - Single Bundle Extract (R)
  1509.  
  1510.                 When enabled,  IMAIL  will try  to  extract one  bundle  or
  1511.                 packet at a time from compressed mail files.
  1512.  
  1513.                 This option should be used only on systems where disk space
  1514.                 is tight, because it  will slow down  the execution of  the
  1515.                 program noticeably.
  1516.  
  1517.                 Currently, this option will extract the packets in a single
  1518.                 compressed file before processing, but it will extract  ALL
  1519.                 the packets. In  a future  version, IMAIL will  be able  to
  1520.                 extract a single packet  from the compressed file,  process
  1521.                 it and then go on to the next.
  1522.  
  1523.  
  1524.               - Send Return Receipt (R)
  1525.  
  1526.                 If a net  mail messages  arrives with  the "Request  Return
  1527.                 Receipt" flag set, IMAIL will automatically generate a  net
  1528.                 mail message to  the originating system,  stating that  the
  1529.                 message arrived.
  1530.  
  1531.                 Note that the FLAGS RRQ kludge is not supported by IMAIL in
  1532.                 the  current  version.  Since  the  message  attribute   is
  1533.                 defined, I decided to support it.
  1534.  
  1535.  
  1536.               - Forward For (R)
  1537.  
  1538.                 In  previous  versions  of   IMAIL,  inbound  packets   not
  1539.                 addressed to your system were automatically forwarded on to
  1540.                 the destination. Now  it is  possible to  control this.  If
  1541.                 this option  is  enabled,  IMAIL  will  behave  as  before.
  1542.                 Otherwise, it  will  process  the  packet  as  if  it  were
  1543.                 addressed to you.  Thus your normal  mail routing  commands
  1544.                 can take effect.
  1545.  
  1546.                 Note that  if  this  option is  disabled,  it  will  become
  1547.                 impossible to route echo mail packets, because they will be
  1548.                 processed by IMAIL, and the  messages will probably end  up
  1549.                 in your Bad Message board.
  1550.  
  1551.                 In unregistered copies of  IMAIL, Forward For  is set to  N
  1552.                 (disabled).
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.     ════════════════════════════════════════════════════════════════════════
  1559.     (C) Fabiano Fabris 1990, 1991                                    Page 17
  1560.     ════════════════════════════════════════════════════════════════════════
  1561.  
  1562.     ════════════════════════════════════════════════════════════════════════
  1563.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1564.     ════════════════════════════════════════════════════════════════════════
  1565.  
  1566.  
  1567.               - Automatic Message Replies (R)
  1568.  
  1569.                 IMAIL can generate automatic replies  to net mail that  has
  1570.                 been sitting in your Net  Mail directory for longer than  a
  1571.                 specified period.
  1572.  
  1573.                 Specifying a  number of  days  will activate  this  option.
  1574.                 IMAIL will scan  your Net  Mail Directory  for unread  mail
  1575.                 addressed to your  system, which  is older  than the  given
  1576.                 number of days.
  1577.  
  1578.                 If you activate this option, you may also specify the  path
  1579.                 and name of a text file to send as a reply.
  1580.  
  1581.                 For more information, see Chapter 9.
  1582.  
  1583.  
  1584.               - Sysop Name
  1585.  
  1586.                 This field is  required, as  it is  used by  IMAIL for  the
  1587.                 generation of automatic messages and so on. IMAIL also uses
  1588.                 it to validate your registration key file.
  1589.  
  1590.                 For information of how to register IMAIL, see Chapter 2.
  1591.  
  1592.  
  1593.         b. Compression Programs
  1594.  
  1595.            In this section, you may specify the programs, along with  their
  1596.            parameters, to use in the creation of outbound compressed mail.
  1597.  
  1598.            When you run IMSETUP for the  first time, it will show  defaults
  1599.            for the following programs:
  1600.  
  1601.               ARC by System Enhancement Associates;
  1602.               Arj by Robert K. Jung
  1603.               LHarc by Haruyasu Yoshizaki;
  1604.               PKARC/PKPAK by PKWARE Inc.;
  1605.               PAK by NoGate Consulting;
  1606.               PKZip by PKWARE Inc.;
  1607.               ZOO by Rhaul Dhesi.
  1608.  
  1609.            If you wish, you may add  other programs of your own choice,  or
  1610.            delete those you do not intend to use.
  1611.  
  1612.            Of course, all of the programs you intend to use must be present
  1613.            somewhere in the DOS path.
  1614.  
  1615.            You will then  select which of  these programs to  use for  mail
  1616.            compression on a  per-system basis, in  the Node Export  Manager
  1617.            (see Section e.). If IMAIL needs  to compress mail for a  system
  1618.            not listed, it will use the first of those given in this menu.
  1619.  
  1620.  
  1621.  
  1622.  
  1623.     ════════════════════════════════════════════════════════════════════════
  1624.     (C) Fabiano Fabris 1990, 1991                                    Page 18
  1625.     ════════════════════════════════════════════════════════════════════════
  1626.  
  1627.     ════════════════════════════════════════════════════════════════════════
  1628.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1629.     ════════════════════════════════════════════════════════════════════════
  1630.  
  1631.  
  1632.         c. Decompression Programs
  1633.  
  1634.            IMAIL automagically recognizes compressed files produced by  the
  1635.            following programs:
  1636.  
  1637.               ARC by System Enhancement Associates;
  1638.               Arj by Robert K. Jung
  1639.               LHarc by Haruyasu Yoshizaki;
  1640.               PKARC/PKPAK by PKWARE Inc.;
  1641.               PAK by NoGate Consulting;
  1642.               PKZip by PKWARE Inc.;
  1643.               ZOO by Rhaul Dhesi.
  1644.  
  1645.            In this menu, you may change the name and parameters which  will
  1646.            be executed when compressed mail files are identified.
  1647.  
  1648.            It is also possible to define a program which should be  invoked
  1649.            if IMAIL is not able to  determine the type of compression  used
  1650.            to create an ARCmail file. If  this entry is not defined,  IMAIL
  1651.            will simply ignore the file.
  1652.  
  1653.            Be VERY careful when changing  these items, for a mistake  might
  1654.            produce  very  unexpected  (and  often  unwanted)  results.  And
  1655.            certainly do NOT try  to use one program  instead of another.  A
  1656.            compressed file identified as having been created by LHarc,  for
  1657.            example, cannot be decompressed by ARC!
  1658.  
  1659.            If possible, have all of the decompression programs somewhere in
  1660.            the DOS path, unless  you are absolutely  certain that you  will
  1661.            not be getting mail compressed by one or more of them.
  1662.  
  1663.  
  1664.         d. Echo Areas
  1665.  
  1666.            The echo area manager is one of the most important parts of  the
  1667.            program, and also controls most of what IMAIL does.
  1668.  
  1669.            When you first run IMSETUP, no echo areas are defined. You  will
  1670.            see a screen  with many different  fields, all empty  or set  to
  1671.            certain default  values. These  fields will  be explained  in  a
  1672.            moment, but first the editing keys.
  1673.  
  1674.            Note: users who are changing over from other mail processors may
  1675.            prefer  to  import  their   existing  echo  area   configuration
  1676.            information. See Chapter 5. section g.
  1677.  
  1678.  
  1679.            1) Editing Keys
  1680.  
  1681.               The following keys  will allow  you to edit,  add, delete  or
  1682.               find echo area records. They are:
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.     ════════════════════════════════════════════════════════════════════════
  1689.     (C) Fabiano Fabris 1990, 1991                                    Page 19
  1690.     ════════════════════════════════════════════════════════════════════════
  1691.  
  1692.     ════════════════════════════════════════════════════════════════════════
  1693.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1694.     ════════════════════════════════════════════════════════════════════════
  1695.  
  1696.  
  1697.               - F1: Edit
  1698.  
  1699.                 The F1 key allows you to edit the current echo area  record
  1700.                 (ie the one currently being displayed). For the meaning  of
  1701.                 each of the fields, see below.
  1702.  
  1703.                 If at any  time during  editing you wish  to abort,  simply
  1704.                 press ESC, and nothing will be  saved. The same is true  if
  1705.                 you were adding an area: it will be "forgotten".
  1706.  
  1707.  
  1708.               - F2: Find
  1709.  
  1710.                 Pressing F2 brings up a window in which you may specify  an
  1711.                 area name. If the area is  found, it will be displayed;  if
  1712.                 not, the area which most  closely matches the required  one
  1713.                 will be displayed. It may then be edited with F1.
  1714.  
  1715.  
  1716.               - F3: Global
  1717.  
  1718.                 If you  need  to  make  global changes  to  the  echo  area
  1719.                 information, pressing  F3 will  bring  up the  Global  Edit
  1720.                 menu. From this, it is  possible to edit the origin  lines,
  1721.                 origin addresses, or to add,  delete or replace systems  in
  1722.                 the export list.
  1723.  
  1724.                 In each  case, the  changes  will be  made on  a  per-group
  1725.                 basis. One  or  more  groups  may  be  specified,  and  the
  1726.                 modifications will be made for all echo areas which  belong
  1727.                 to the selected groups.
  1728.  
  1729.                 To close  the Global  Edit  menu, press  ESC; you  will  be
  1730.                 returned to the main Area Manager screen.
  1731.  
  1732.  
  1733.               - F4: Browse
  1734.  
  1735.                 The browse function will allow you to examine a list of all
  1736.                 the currently defined echo areas, and to move quickly to  a
  1737.                 specific record. The  window shows  some information  about
  1738.                 each area. For example, an entry might read:
  1739.  
  1740.                    95 N APSTK  TEST_ECHO   [A]
  1741.  
  1742.                 The number indicates  the board. This  first letter is  the
  1743.                 group to which the  area belongs. There  follow up to  five
  1744.                 letters which indicate  the status of  the area; these  are
  1745.                 followed by the area name.
  1746.  
  1747.                 The status letter have the following meanings:
  1748.                    A = Active
  1749.                    P = Passthrough
  1750.  
  1751.  
  1752.  
  1753.     ════════════════════════════════════════════════════════════════════════
  1754.     (C) Fabiano Fabris 1990, 1991                                    Page 20
  1755.     ════════════════════════════════════════════════════════════════════════
  1756.  
  1757.     ════════════════════════════════════════════════════════════════════════
  1758.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1759.     ════════════════════════════════════════════════════════════════════════
  1760.  
  1761.  
  1762.                    S = Secure
  1763.                    T = Tiny-Seens
  1764.                    K = Keep Seen-bys
  1765.  
  1766.                 The last indicator may not be present; it is displayed  for
  1767.                 those areas which have been automatically added by AreaLink
  1768.                 or by TOSS.
  1769.  
  1770.  
  1771.               - F10: Save
  1772.  
  1773.                 The F10 key is  used to exit the  Area Manager, saving  any
  1774.                 changes made.
  1775.  
  1776.  
  1777.               - Ins: Add
  1778.  
  1779.                 Adds a  new echo  area, and  takes you  into editing  mode.
  1780.                 Added records are automatically  inserted into the list  so
  1781.                 that it is maintained in alphabetical order.
  1782.  
  1783.  
  1784.               - Del: Delete
  1785.  
  1786.                 Deletes the  current  echo  area. You  will  be  asked  for
  1787.                 confirmation.
  1788.  
  1789.  
  1790.               - Home: First
  1791.  
  1792.                 Takes you  to  the first  echo  area (they  are  sorted  in
  1793.                 ascending alphabetical order).
  1794.  
  1795.  
  1796.               - End: Last
  1797.  
  1798.                 Takes you to the last echo area.
  1799.  
  1800.  
  1801.               - ESC: Exit
  1802.  
  1803.                 ESC is  used  to  exit the  Area  Manager,  abandoning  any
  1804.                 changes made. You will  be asked if you  are sure that  you
  1805.                 want to abandon the changes; if you reply 'N', you will  be
  1806.                 returned to the Manager.
  1807.  
  1808.  
  1809.               - PgUp/PgDn: Previous/Next
  1810.  
  1811.                 The PgUp and PgDn keys move between the echo area  records.
  1812.                 Once you have found  the one you are  looking for, you  may
  1813.                 edit it with F1.  (Note that the arrow  keys have the  same
  1814.                 effect as PgUp and PgDn.)
  1815.  
  1816.  
  1817.  
  1818.     ════════════════════════════════════════════════════════════════════════
  1819.     (C) Fabiano Fabris 1990, 1991                                    Page 21
  1820.     ════════════════════════════════════════════════════════════════════════
  1821.  
  1822.     ════════════════════════════════════════════════════════════════════════
  1823.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1824.     ════════════════════════════════════════════════════════════════════════
  1825.  
  1826.  
  1827.            2) The Echo Area Record
  1828.  
  1829.               What follows is a description of the individual fields of the
  1830.               echo area record, and how they are used and changed.
  1831.  
  1832.               All fields are required unless stated otherwise.
  1833.  
  1834.  
  1835.               - Area Name
  1836.  
  1837.                 This is the name of  the echo area, sometimes called  "Area
  1838.                 Tag". The name may be up to 20 characters long; it will  be
  1839.                 forced into upper case. Special characters such as '-', '_'
  1840.                 and '.' may be  used, but no spaces  may appear. Please  be
  1841.                 sure of  the spelling  of the  name, since  it is  used  to
  1842.                 identify which board an  incoming message should be  tossed
  1843.                 into.
  1844.  
  1845.                 Note that it is not possible  to define two areas with  the
  1846.                 same area name.  IMSETUP will show  a warning message,  and
  1847.                 you will  be  prompted to  correct  the name.  This  is  to
  1848.                 prevent cross-linked areas.
  1849.  
  1850.  
  1851.               - Active
  1852.  
  1853.                 This by default is  set to 'Y', which  means that the  echo
  1854.                 area is active. If set to 'N', IMAIL will behave as if  the
  1855.                 area had not been defined.
  1856.  
  1857.                 This will allow you to disable an echo area for any  reason
  1858.                 you may wish,  without having  to actually  delete it,  and
  1859.                 later re-enter it.
  1860.  
  1861.  
  1862.               - Comment
  1863.  
  1864.                 Here  you  may  enter  a   brief  (up  to  60   characters)
  1865.                 description of the area. This  description is used by  some
  1866.                 of the export functions (see Section e.), and may also help
  1867.                 remind you what the subject of the echo is.
  1868.  
  1869.                 Note that  if  the  area  was  auto-added  by  TOSS  or  by
  1870.                 AreaLink, the comment will be set to the name of the area.
  1871.  
  1872.                 This field is optional.
  1873.  
  1874.  
  1875.               - Origin Line
  1876.  
  1877.                 Here you may specify up to 63 characters which will be used
  1878.                 as the origin line for the  echo area (see Chapter 11.  for
  1879.                 more information on Origin lines).
  1880.  
  1881.                 To this will be prefixed the string
  1882.  
  1883.     ════════════════════════════════════════════════════════════════════════
  1884.     (C) Fabiano Fabris 1990, 1991                                    Page 22
  1885.     ════════════════════════════════════════════════════════════════════════
  1886.  
  1887.     ════════════════════════════════════════════════════════════════════════
  1888.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1889.     ════════════════════════════════════════════════════════════════════════
  1890.  
  1891.  
  1892.                     * Origin:
  1893.  
  1894.                 and your origin address (see  below) will be appended.  The
  1895.                 total length must not exceed 79 characters.
  1896.  
  1897.                 If you forget to define this field, the default origin line
  1898.                 will be used. Note that if  the BBS or editor program  used
  1899.                 to write an echo message  already adds an origin line,  the
  1900.                 one defined here will not be used.
  1901.  
  1902.  
  1903.               - Board
  1904.  
  1905.                 In  this  field  you   should  specify  the  board   number
  1906.                 corresponding to the echo area.
  1907.  
  1908.                 The board number may  be between 1  and 200 inclusive  (the
  1909.                 upper limit is imposed by  QuickBBS). The number 0 is  used
  1910.                 by IMAIL to indicate a passthrough area (see below).
  1911.  
  1912.                 IMSETUP will not let you  use the same board number  twice,
  1913.                 because you would be cross-linking echo areas. If you press
  1914.                 F4, a list of all unused  board numbers will be shown,  and
  1915.                 you may select one  from it by pressing  ENTER. If you  are
  1916.                 changing the board number, the highlight bar will be placed
  1917.                 on the currently defined board  number; ESC will allow  you
  1918.                 to retain the current definition.
  1919.  
  1920.                 TOSS uses this number  when importing echo messages,  since
  1921.                 the  QuickBBS/RemoteAccess   message   bases   contain   no
  1922.                 indication of the area name.  Similarly, SCAN uses this  to
  1923.                 derive the name of an echo area when exporting mail.
  1924.  
  1925.  
  1926.               - Passthrough
  1927.  
  1928.                 If set  to 'Y',  this area  is marked  as passthrough  (and
  1929.                 consequently the board number zeroed).
  1930.  
  1931.                 In other words, echo mail arriving in this area will NOT be
  1932.                 imported into your message base, but only passed on to  any
  1933.                 other systems you might be feeding. If you are not  feeding
  1934.                 any systems, the messages will simply be killed.
  1935.  
  1936.  
  1937.               - Secure
  1938.  
  1939.                 If enabled,  IMAIL will  check the  address of  the  system
  1940.                 which sent the  message in this  area. If it  is among  the
  1941.                 export nodes listed in the Export List (see below), it will
  1942.                 be imported  and processed;  otherwise, it  will be  tossed
  1943.                 into your Bad Message Board.
  1944.  
  1945.  
  1946.  
  1947.  
  1948.     ════════════════════════════════════════════════════════════════════════
  1949.     (C) Fabiano Fabris 1990, 1991                                    Page 23
  1950.     ════════════════════════════════════════════════════════════════════════
  1951.  
  1952.     ════════════════════════════════════════════════════════════════════════
  1953.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  1954.     ════════════════════════════════════════════════════════════════════════
  1955.  
  1956.  
  1957.               - # Days
  1958.  
  1959.                 This item  is used  by IMTHINGS  KILL /U  (see Chapter  10.
  1960.                 Section c.) to  determine which messages  to kill: it  will
  1961.                 mark as deleted any messages older than the number of  days
  1962.                 specified here. If this field is left at zero, no  messages
  1963.                 will  be  killed,  unless  the  "#  Msgs"  field  below  is
  1964.                 specified.
  1965.  
  1966.                 The maximum value  which can  be entered in  this field  is
  1967.                 255.
  1968.  
  1969.                 If the area  is marked  as Passthrough, this  field has  no
  1970.                 meaning.
  1971.  
  1972.  
  1973.               - Group
  1974.  
  1975.                 A letter  between A  and Z  which identifies  the group  to
  1976.                 which this echo belongs.
  1977.  
  1978.                 Groups are  used  primarily  by the  AreaLink  function  to
  1979.                 indicate which nodes may request links to which echo areas.
  1980.  
  1981.                 For more information on this,  see Section e., and  Chapter
  1982.                 8.
  1983.  
  1984.                 If the area was auto-added by TOSS or AreaLink, this  field
  1985.                 will be set to '?', and so  will have to be edited to  give
  1986.                 it a valid value.
  1987.  
  1988.  
  1989.               - Tiny-Seens
  1990.  
  1991.                 Enable this option  if you  want to strip  all the  SEEN-BY
  1992.                 information from  an incoming  echo  message before  it  is
  1993.                 re-exported.
  1994.  
  1995.                 In this case,  the outgoing message  will contain only  the
  1996.                 SEEN-BYs of your downlinks. Note, however, that if the area
  1997.                 is not marked as passthrough, and if the Keep-Seens  option
  1998.                 (below) is active,  the message will  be imported with  the
  1999.                 original SEEN-BY information.
  2000.  
  2001.  
  2002.               - Keep-Seens
  2003.  
  2004.                 Enable this  option  if  you want  to  import  the  SEEN-BY
  2005.                 information  into  your  message  base.  If  disabled,  the
  2006.                 SEEN-BY lines will be stripped from the message.
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.     ════════════════════════════════════════════════════════════════════════
  2014.     (C) Fabiano Fabris 1990, 1991                                    Page 24
  2015.     ════════════════════════════════════════════════════════════════════════
  2016.  
  2017.     ════════════════════════════════════════════════════════════════════════
  2018.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2019.     ════════════════════════════════════════════════════════════════════════
  2020.  
  2021.  
  2022.               - # Msgs
  2023.  
  2024.                 This is used by IMTHINGS  KILL /U (see Chapter 10.  Section
  2025.                 c.) to determine how many messages to leave in this  board.
  2026.                 If this field is left at  zero, it will be ignored, and  no
  2027.                 messages will be  killed, unless  the "#  Days" field  (see
  2028.                 above) is specified.
  2029.  
  2030.                 Naturally, if the  area is Passthrough,  this field has  no
  2031.                 meaning.
  2032.  
  2033.  
  2034.               - Origin Address
  2035.  
  2036.                 Pressing F1 while editing an area will allow you to  choose
  2037.                 the address to use in the Origin line of the message.
  2038.  
  2039.                 You will be presented  with a window  containing a list  of
  2040.                 all the addresses defined  in the "System Addresses"  menu;
  2041.                 select one of these.
  2042.  
  2043.                 This address will also be used in the PATH line of the echo
  2044.                 message, as well as in the list of SEEN-BYs.
  2045.  
  2046.                 Note that only the net and  node numbers will be placed  in
  2047.                 the SEEN-BYs  and PATH  lines; the  use of  zone and  point
  2048.                 numbers is not  accepted. However, IMAIL  is able to  parse
  2049.                 zone and point information from these lines, if found.
  2050.  
  2051.  
  2052.               - Seen-Bys
  2053.  
  2054.                 Pressing F2 while editing an area will allow you to  choose
  2055.                 one or more addresses to add  to the SEEN-BY line for  that
  2056.                 area.
  2057.  
  2058.                 If you do not select any addresses, then the one  specified
  2059.                 as "Origin Address" will by default be used.
  2060.  
  2061.                 Note, as above,  that zone  and point numbers  will not  be
  2062.                 placed in the SEEN-BY lines generated by IMAIL.
  2063.  
  2064.  
  2065.               - Export List
  2066.  
  2067.                 Pressing F3 will  bring up the  Export List Manager.  Here,
  2068.                 you may specify up to 60 systems to which this echo will be
  2069.                 exported. At least one node must be defined to TOSS or SCAN
  2070.                 to/from the area.
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.     ════════════════════════════════════════════════════════════════════════
  2079.     (C) Fabiano Fabris 1990, 1991                                    Page 25
  2080.     ════════════════════════════════════════════════════════════════════════
  2081.  
  2082.     ════════════════════════════════════════════════════════════════════════
  2083.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2084.     ════════════════════════════════════════════════════════════════════════
  2085.  
  2086.  
  2087.         e. Node Export Manager
  2088.  
  2089.            The Node Export Manager is used to specify information regarding
  2090.            the systems to which you  normally export mail, including  which
  2091.            program will be used to  compress outbound mail for the  system,
  2092.            as well as what type of file attach to generate.
  2093.  
  2094.  
  2095.            1) Editing Keys
  2096.  
  2097.               The following keys  will allow  you to edit,  add, delete  or
  2098.               find node records. They are:
  2099.  
  2100.  
  2101.               - F1: Edit
  2102.  
  2103.                 The F1 key allows you to  edit the current node record  (ie
  2104.                 the one currently being displayed). For the meaning of each
  2105.                 of the fields, see below.
  2106.  
  2107.                 If at any  time during  editing you wish  to abort,  simply
  2108.                 press ESC, and nothing will be  saved. The same is true  if
  2109.                 you were adding an entry: it will be "forgotten".
  2110.  
  2111.  
  2112.               - F2: Find
  2113.  
  2114.                 Pressing F2 brings up a window  in which you may specify  a
  2115.                 node number. If the address is found, it will be displayed.
  2116.                 It may then be edited with F1.
  2117.  
  2118.  
  2119.               - F4: Browse
  2120.  
  2121.                 The browse function will allow you to examine a list of all
  2122.                 the currently  defined  nodes, and  to  move quickly  to  a
  2123.                 specific record. The  window shows  some information  about
  2124.                 system. For example, an entry might read:
  2125.  
  2126.                    27:1331/1  C  ANP
  2127.  
  2128.                 The letter following the node address indicates the status:
  2129.                 H means Hold, C  is Crash, while N  is normal. The  letters
  2130.                 following are the groups to which that system has access.
  2131.  
  2132.  
  2133.               - F10: Save
  2134.  
  2135.                 The F10 key is  used to exit the  Node Manager, saving  any
  2136.                 changes made.
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.     ════════════════════════════════════════════════════════════════════════
  2144.     (C) Fabiano Fabris 1990, 1991                                    Page 26
  2145.     ════════════════════════════════════════════════════════════════════════
  2146.  
  2147.     ════════════════════════════════════════════════════════════════════════
  2148.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2149.     ════════════════════════════════════════════════════════════════════════
  2150.  
  2151.  
  2152.               - Ins: Add
  2153.  
  2154.                 Adds a new entry,  and takes you  into editing mode.  Added
  2155.                 records are automatically inserted into the list so that is
  2156.                 it maintained in order.
  2157.  
  2158.  
  2159.               - Del: Delete
  2160.  
  2161.                 Deletes  the  current  record.   You  will  be  asked   for
  2162.                 confirmation.
  2163.  
  2164.  
  2165.               - Home: First
  2166.  
  2167.                 Takes you to the first record (they are sorted in ascending
  2168.                 alphabetical order).
  2169.  
  2170.  
  2171.               - End: Last
  2172.  
  2173.                 Takes you to the last node in the list.
  2174.  
  2175.  
  2176.               - ESC: Exit
  2177.  
  2178.                 ESC is  used  to  exit the  Node  Manager,  abandoning  any
  2179.                 changes made. You will  be asked if you  are sure that  you
  2180.                 want to abandon the changes; if you reply 'N', you will  be
  2181.                 returned to the Manager.
  2182.  
  2183.  
  2184.               - PgUp/PgDn: Previous/Next
  2185.  
  2186.                 The PgUp and PgDn keys  move between the records. Once  you
  2187.                 have found the  one you are  looking for, you  may edit  it
  2188.                 with F1. (Note that the arrow keys have the same effect  as
  2189.                 PgUp and PgDn.)
  2190.  
  2191.  
  2192.            2) Address
  2193.  
  2194.               Here you specify the address of the system. The Zone, Net and
  2195.               node are required. If no point is specified, it will  default
  2196.               to 0.
  2197.  
  2198.  
  2199.            3) Password
  2200.  
  2201.               If specified, this will be the password that the system  will
  2202.               use when requesting areas or  information from Area Link.  If
  2203.               no password  is specified,  the system  may not  request  any
  2204.               areas, even if one or more groups have been enabled.
  2205.  
  2206.               For more information on Area Link, see Chapter 8.
  2207.  
  2208.     ════════════════════════════════════════════════════════════════════════
  2209.     (C) Fabiano Fabris 1990, 1991                                    Page 27
  2210.     ════════════════════════════════════════════════════════════════════════
  2211.  
  2212.     ════════════════════════════════════════════════════════════════════════
  2213.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2214.     ════════════════════════════════════════════════════════════════════════
  2215.  
  2216.  
  2217.            4) Groups
  2218.  
  2219.               List the Groups to which the system may have access. Up to 26
  2220.               may be specified.
  2221.  
  2222.               A system must  have a Group  enabled in order  to be able  to
  2223.               request a link to any echo area which is part of that Group.
  2224.  
  2225.  
  2226.            5) Direct
  2227.  
  2228.               If this flag is set to  'Y', ARCmail generated for this  node
  2229.               will be  marked DIRECT.  In  other words,  it will  not  (and
  2230.               cannot) be routed. If it is set to 'N', it will not be marked
  2231.               as DIRECT, and thus can be routed via other systems.
  2232.  
  2233.               It is STRONGLY recommended that  echo mail NOT be routed,  so
  2234.               if the node is your echo mail feed, it is best to mark it  as
  2235.               Direct.
  2236.  
  2237.               Note that any systems  not defined in  the Node Manager  will
  2238.               not have their mail marked DIRECT.
  2239.  
  2240.  
  2241.            6) Remote Maint (R)
  2242.  
  2243.               Registered users  of IMAIL  may allow  systems to  carry  out
  2244.               changes in the links for other systems. These changes may  be
  2245.               made via AreaLink, using the %FROM meta-command (see  Chapter
  2246.               8. section b.).
  2247.  
  2248.               In order to  enable a node  to make these  changes for  other
  2249.               systems, this field must be set to 'Y'; the default is 'N'.
  2250.  
  2251.               Remote Maint also allows  the system to  delete an echo  area
  2252.               from your list,  or to change  the name of  an area. It  thus
  2253.               allows a lot of control over your system.
  2254.  
  2255.  
  2256.            7) Status
  2257.  
  2258.               Pressing F1 while editing a node's information will allow you
  2259.               to change  the  file  attach  status.  By  default,  this  is
  2260.               "Normal", but you may select one of:
  2261.  
  2262.                  Normal       No status
  2263.                  Hold         Hold message for pick up
  2264.                  Crash        Send message Crash
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.     ════════════════════════════════════════════════════════════════════════
  2274.     (C) Fabiano Fabris 1990, 1991                                    Page 28
  2275.     ════════════════════════════════════════════════════════════════════════
  2276.  
  2277.     ════════════════════════════════════════════════════════════════════════
  2278.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2279.     ════════════════════════════════════════════════════════════════════════
  2280.  
  2281.  
  2282.            8) Program
  2283.  
  2284.               If you press F2 while editing a node's information, you  will
  2285.               be able to select the program to use for mail compression.  A
  2286.               list will appear, containing the programs you defined in  the
  2287.               "Compression Programs" menu,
  2288.  
  2289.               If you make no selection, by default the first program in the
  2290.               list will be used.
  2291.  
  2292.               Note that  is  is possible  to  specify that  no  compression
  2293.               program be used (the last entry  in the list). In this  case,
  2294.               PKT files  addressed to  the node  being edited  will not  be
  2295.               compressed, and will simply be  file attached to the  system.
  2296.               This allows simple mail processors to receive mail from IMAIL
  2297.               systems without  needing to  have one  or more  decompression
  2298.               programs available.
  2299.  
  2300.  
  2301.            9) Capability
  2302.  
  2303.               The Capability describes the  other system's mail  processor.
  2304.               Currently, two types are defined:
  2305.  
  2306.                  Stone Age
  2307.                  Type 2+
  2308.  
  2309.               Set this field  according to the  capability of the  system's
  2310.               mail processor, if known. If you are unsure, leave the  field
  2311.               set to "Stone Age".
  2312.  
  2313.               Note,  that  it  is  possible  to  define  as  Type  2+  mail
  2314.               processors which are not normally detected as such but  which
  2315.               have the  zone and  point information.  This is  done in  the
  2316.               Product Code menu (see above).
  2317.  
  2318.               For more information  on the  capability word,  refer to  the
  2319.               FTSC documents  FSC-0039  and FSC-0048.  See  also  FTS-0001.
  2320.               These documents  may be  available  near you;  otherwise  you
  2321.               should be able to file  request them from 1:1/20. Refer  also
  2322.               to Chapter 14. Section a.
  2323.  
  2324.               Note that IMAIL will always generate "Type 2+" information in
  2325.               the packet  header, and  identify itself  as a  Type 2+  mail
  2326.               processor, regardless of the setting of this field.
  2327.  
  2328.  
  2329.            10) Cap Handling
  2330.  
  2331.               This field  allows  you to  define  how IMAIL  will  use  the
  2332.               setting defined in the Capability field when handling inbound
  2333.               mail. If it  is set  to "Force",  IMAIL will  always use  the
  2334.               setting defined in the  Capability field, regardless of  what
  2335.               the actual format of the inbound packet(s) might be.
  2336.  
  2337.  
  2338.     ════════════════════════════════════════════════════════════════════════
  2339.     (C) Fabiano Fabris 1990, 1991                                    Page 29
  2340.     ════════════════════════════════════════════════════════════════════════
  2341.  
  2342.     ════════════════════════════════════════════════════════════════════════
  2343.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2344.     ════════════════════════════════════════════════════════════════════════
  2345.  
  2346.  
  2347.               Instead, if set to  "Auto", IMAIL will  try to determine  the
  2348.               type of  packet  by examining  the  Capability Word  and  its
  2349.               validation copy and/or the product code, and process the file
  2350.               accordingly.
  2351.  
  2352.               Please note that IMAIL  cannot correctly handle points  which
  2353.               use "Stone  Age"  mail  processors,  unless  they  are  using
  2354.               fakenet addresses.
  2355.  
  2356.               Note also  that if  TOSS  processes mail  from a  system  not
  2357.               listed in the node manager, it will "Auto-add" it to the list
  2358.               of nodes (this will be indicated in the edit window),  giving
  2359.               the determined Capability, and handling it as "Auto".
  2360.  
  2361.  
  2362.         f. Pack Routing
  2363.  
  2364.            In this menu  you may  specify default routing  for IMPACK  (see
  2365.            Chapter 6. Section 7.); in other words, you may specify that net
  2366.            mail for one or more systems be compressed in a packet addressed
  2367.            to another  system, from  which (presumably)  the mail  will  be
  2368.            forwarded on.
  2369.  
  2370.            The menu is composed of two "Route Via" columns, which  indicate
  2371.            the nodes via  which net  mail will  be routed.  For reasons  of
  2372.            spaces, the routed nodes are not shown except when editing.
  2373.  
  2374.            If no systems are listed as "Routed Systems", IMPACK will simply
  2375.            look for and compress mail for the "Route Via" address.
  2376.  
  2377.            To edit these entries,  position the cursor  on the desired  row
  2378.            and press ENTER. You will then  be able to edit the "Route  Via"
  2379.            address. Once finished,  another ENTER  will automatically  take
  2380.            you to  the  list of  "Routed  Systems", which  you  may  modify
  2381.            individually.
  2382.  
  2383.            It is possible to  insert new entries  between existing ones  by
  2384.            pressing INS, and to  delete entries (permanently!) by  pressing
  2385.            DEL.
  2386.  
  2387.            IMSETUP supports the use of the "ALL" macro when specifying  the
  2388.            "Routed Systems". This macro  may be used in  place of the  net,
  2389.            node or  point fields  (the zone  should always  be given).  For
  2390.            example:
  2391.  
  2392.               2:All                  All net  mail  messages  addressed  to
  2393.                                      systems in Zone 2
  2394.  
  2395.               2:230/All              All net mail messages addressed to the
  2396.                                      nodes in Zone 2, Net 230
  2397.  
  2398.               27:230/100.All         All net mail messages addressed to the
  2399.                                      points of  node 2:230/100.  Note  that
  2400.                                      this is equivalent to:
  2401.  
  2402.  
  2403.     ════════════════════════════════════════════════════════════════════════
  2404.     (C) Fabiano Fabris 1990, 1991                                    Page 30
  2405.     ════════════════════════════════════════════════════════════════════════
  2406.  
  2407.     ════════════════════════════════════════════════════════════════════════
  2408.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2409.     ════════════════════════════════════════════════════════════════════════
  2410.  
  2411.  
  2412.               27:1331/100            By default, IMAIL  will pack net  mail
  2413.                                      messages for  a  point  via  its  boss
  2414.                                      node. If  you  wish to  indicate  only
  2415.                                      certain  points,  you  will  have   to
  2416.                                      specify them explicitly:
  2417.  
  2418.               2:230/100.1            This will pack messages for point 1 of
  2419.                                      the  system  2:230/100  via  the  node
  2420.                                      specified in the "Route Via" column.
  2421.  
  2422.            If you do  not specify the  Zone, IMSETUP will  use the Zone  as
  2423.            defined in your primary address.
  2424.  
  2425.            Note that if you are a "boss" node, net mail to your points will
  2426.            never be pack routed unless  explicitly specified (see the  last
  2427.            example above). So if your address is 2:230/41, and you wish  to
  2428.            pack net mail  for your points  via 2:230/40, you  will need  to
  2429.            have "2:230/41.All" in the list of Routed Systems.
  2430.  
  2431.  
  2432.         g. Import/Export
  2433.  
  2434.            Users of IMAIL  have available to  them a series  of import  and
  2435.            export functions. These are listed below.
  2436.  
  2437.  
  2438.            1) Import Areas.Bbs
  2439.  
  2440.               With this function, you may import the information  contained
  2441.               in an AREAS.BBS file. This file must conform to the  standard
  2442.               used  by  QuickBBS/QEcho   systems.  In   other  words,   the
  2443.               recognized format is:
  2444.  
  2445.                  <board number> <area name> <export list>
  2446.  
  2447.               The board number should be between 1 and 200.  Alternatively,
  2448.               it may be  the letter 'P',  in which case,  the area will  be
  2449.               marked as Passthrough.
  2450.  
  2451.               The area name is  the name of  the echo area,  and may be  in
  2452.               lower case or  upper case;  it will be  converted into  upper
  2453.               case when imported.
  2454.  
  2455.               The export list is the list  of systems to which you will  be
  2456.               feeding the echo. If no zone is specified, it will default to
  2457.               your primary zone. However, both the zone and net numbers are
  2458.               "sticky", which means that if  specified, they will be  valid
  2459.               until changed. For example:
  2460.  
  2461.                  2:310/11 12 13
  2462.  
  2463.               means that you  will be exporting  to 2:310/11, 2:310/12  and
  2464.               2:310/13. Point  numbers may  also  be specified.  Thus  this
  2465.               function actually recognizes a superset of the QEcho format.
  2466.  
  2467.  
  2468.     ════════════════════════════════════════════════════════════════════════
  2469.     (C) Fabiano Fabris 1990, 1991                                    Page 31
  2470.     ════════════════════════════════════════════════════════════════════════
  2471.  
  2472.     ════════════════════════════════════════════════════════════════════════
  2473.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2474.     ════════════════════════════════════════════════════════════════════════
  2475.  
  2476.  
  2477.               Note that the  first line of  the file will  be ignored,  and
  2478.               anything on a line following a semi-colon (';') will also  be
  2479.               discarded. Therefore,  the file  may  contain any  number  of
  2480.               comments.
  2481.  
  2482.               If the board number and/or the area name are already  defined
  2483.               in IMSETUP, you will  be asked if you  wish to overwrite  the
  2484.               area information, or create a  new area. In the second  case,
  2485.               you will be  prompted for a  new board number.  You may  also
  2486.               choose to skip the import of that area; this is the  default.
  2487.               In other words, if you press <Enter> or <ESC>, the area  will
  2488.               be skipped, and processing will  continue with the next  line
  2489.               of the Areas file.
  2490.  
  2491.               Once the Areas.Bbs  file has  been imported, go  to the  Echo
  2492.               Area Manager and edit the comment field, the Origin line, the
  2493.               Group and the  SEEN-BY addresses, and  any other  information
  2494.               you wish to change.
  2495.  
  2496.  
  2497.            2) Export Areas Config (R)
  2498.  
  2499.               With this  function,  you  may  export part  or  all  of  the
  2500.               information  regarding  the  echo  areas  you  have  defined.
  2501.               Specify the Groups for which you want information exported.
  2502.  
  2503.               A file is created  containing all the information  pertaining
  2504.               to each area, and ordered alphabetically by area. This may be
  2505.               used for your own reference, or to send to other systems.
  2506.  
  2507.  
  2508.            3) Create Areas.Bbs File
  2509.  
  2510.               This option  allows you  to create  an Areas.Bbs  type  file,
  2511.               which may then be used by other programs.
  2512.  
  2513.               Note that the first line  of the generated file will  contain
  2514.               information about  your  system, and  the  second will  be  a
  2515.               comment.
  2516.  
  2517.               The format  of  the  generated  file  is  the  same  as  that
  2518.               recognized by the Import  function (see above). However,  the
  2519.               system   number    are   always    given   in    full    form
  2520.               (Zone:Net/Node.Point).
  2521.  
  2522.               Note that Autoadded and deleted areas will not be listed.
  2523.  
  2524.  
  2525.            4) Export Group List (R)
  2526.  
  2527.               Selecting this  function will  generate a  file containing  a
  2528.               list of all echos ordered by Group.
  2529.  
  2530.               The data consists simply of the area name and comment.
  2531.  
  2532.  
  2533.     ════════════════════════════════════════════════════════════════════════
  2534.     (C) Fabiano Fabris 1990, 1991                                    Page 32
  2535.     ════════════════════════════════════════════════════════════════════════
  2536.  
  2537.     ════════════════════════════════════════════════════════════════════════
  2538.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2539.     ════════════════════════════════════════════════════════════════════════
  2540.  
  2541.  
  2542.            5) Export Nodes Config (R)
  2543.  
  2544.               This will create a file containing all the information on the
  2545.               systems defined with the Node Manager.
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.     ════════════════════════════════════════════════════════════════════════
  2599.     (C) Fabiano Fabris 1990, 1991                                    Page 33
  2600.     ════════════════════════════════════════════════════════════════════════
  2601.  
  2602.     ════════════════════════════════════════════════════════════════════════
  2603.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2604.     ════════════════════════════════════════════════════════════════════════
  2605.  
  2606.  
  2607.      6. IMAIL COMMAND LINE OPTIONS
  2608.  
  2609.         Once you have configured the program via IMSETUP, you are ready  to
  2610.         use  IMAIL.  There  are   three  separate  commands  or   functions
  2611.         "contained" in IMAIL, and they are invoked via the command line.
  2612.  
  2613.         The syntax used to invoke IMAIL is:
  2614.  
  2615.            IMAIL TOSS | SCAN | ALNK | /?
  2616.  
  2617.         The switch ? may be prefixed with a dash (-) or a slash (/);  IMAIL
  2618.         will recognize both. If no command  is given, IMAIL will display  a
  2619.         help screen, and return to the DOS prompt.
  2620.  
  2621.         Here is a description of the commands.
  2622.  
  2623.  
  2624.         a. /? - Help
  2625.  
  2626.            This will cause IMAIL to display a brief summary of its  command
  2627.            line options on the screen. Any other commands will be ignored.
  2628.  
  2629.  
  2630.         b. TOSS - Toss Incoming Mail
  2631.  
  2632.            This enables  IMAIL's  TOSS  function.  This  will  search  your
  2633.            inbound files directory  for mail, either  compressed or in  PKT
  2634.            form, and toss  it into  your QuickBBS  or RemoteAccess  message
  2635.            base;  net  mail  messages   will  end  up   in  the  net   mail
  2636.            subdirectory, while  echo  mail will  be  put into  the  correct
  2637.            message area.
  2638.  
  2639.            The TOSS function  will automatically forward  any echo mail  to
  2640.            other links,  as well  as net  mail messages.  Outgoing mail  is
  2641.            automatically compressed, and  a file  attach message  generated
  2642.            (unless the /X option is used).
  2643.  
  2644.            If TOSS finds  that there is  less than 100k  free space on  the
  2645.            working drive while processing,  it will automatically  compress
  2646.            all outgoing mail before going on. This should help prevent disk
  2647.            full errors.
  2648.  
  2649.            Should TOSS  encounter  an ARCmail  file  from which  it  cannot
  2650.            extract the mail packets successfully,  it will rename the  file
  2651.            to have an extension of .BA? so that you can look at it, and  so
  2652.            the file will not be processed again.
  2653.  
  2654.            For information on how TOSS  handles the Capability Word,  refer
  2655.            to Chapter 5. Section e.
  2656.  
  2657.            Note that IMAIL TOSS  will return an ERRORLEVEL  of 1 if it  has
  2658.            processed  net  mail  messages.  This   fact  can  be  used   to
  2659.            selectively call IMAIL ALNK only if net mail messages have  been
  2660.            received.
  2661.  
  2662.  
  2663.     ════════════════════════════════════════════════════════════════════════
  2664.     (C) Fabiano Fabris 1990, 1991                                    Page 34
  2665.     ════════════════════════════════════════════════════════════════════════
  2666.  
  2667.     ════════════════════════════════════════════════════════════════════════
  2668.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2669.     ════════════════════════════════════════════════════════════════════════
  2670.  
  2671.  
  2672.            A note about disk space. Ensuring that there is enough free disk
  2673.            space is  generally the  sysop's responsability.  However,  TOSS
  2674.            will try to avoid system crashes by checking for certain limits.
  2675.            For example, if there is less than 300K free space, it will  not
  2676.            try to extract ARCmail. If there is less than 600K, it will stop
  2677.            extracting any  reminaing  ARCmail, and  finish  processing  any
  2678.            already extracted packets.  If less than  200K remains free,  it
  2679.            will  abort  processing  altogether,  leaving  any   unprocessed
  2680.            packets as they were.
  2681.  
  2682.  
  2683.            1) /B - Check Bad Message Board
  2684.  
  2685.               Use this switch is you wish to force IMAIL to check  messages
  2686.               in  the   Bad  Message   Board.   This  will   override   the
  2687.               configuration setting (see Chapter 5. section a.).
  2688.  
  2689.               What will happen is this: if an echo message is found,  IMAIL
  2690.               will search to see if it  belongs to an area defined in  your
  2691.               Areas file  (IMAIL.AR);  if the  correct  are is  found,  the
  2692.               message will be moved to  the correct board. However, if  the
  2693.               area is marked as Passthrough, the message will be marked  as
  2694.               deleted.
  2695.  
  2696.               Please note  that  if you  are  tossing dupes  into  the  Bad
  2697.               Message Board (rather than having a separate board for them),
  2698.               then any  dupes found  will  also be  moved. This  option  is
  2699.               useful in those cases in which your echo feed has "turned on"
  2700.               an area which has not yet been defined in your areas file.
  2701.  
  2702.  
  2703.            2) /N - No AreaLink
  2704.  
  2705.               Normally, after TOSS has processed incoming messages, it will
  2706.               call AreaLink  to process  any  requests. For  those  systems
  2707.               which do not have downlinks, or which prefer to run  AreaLink
  2708.               separately, this may be disabled.
  2709.  
  2710.               Simply run TOSS with  a /N command  line parameter, as  given
  2711.               below:
  2712.  
  2713.                  IMAIL TOSS /N
  2714.  
  2715.               and AreaLink will not be invoked.
  2716.  
  2717.  
  2718.            3) /R - No Autoreply
  2719.  
  2720.               If you have  AutoReply enabled,  and for some  reason do  not
  2721.               wish to call the function, run TOSS with the /R switch.
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.     ════════════════════════════════════════════════════════════════════════
  2729.     (C) Fabiano Fabris 1990, 1991                                    Page 35
  2730.     ════════════════════════════════════════════════════════════════════════
  2731.  
  2732.     ════════════════════════════════════════════════════════════════════════
  2733.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2734.     ════════════════════════════════════════════════════════════════════════
  2735.  
  2736.  
  2737.            4) /X - No Compression
  2738.  
  2739.               The /X switch will  force TOSS to  not compress any  outgoing
  2740.               packets which  it  has  generated. This  is  useful  only  in
  2741.               multi-tasking environments.
  2742.  
  2743.               The reason for this is that there can be problems if IMAIL is
  2744.               running and the mailer tries to transfer the ARCmail file. In
  2745.               some cases it could happen that the mailer truncuates a  file
  2746.               while IMAIL  is  trying to  access  it; IMAIL  hangs  with  a
  2747.               sharing violation:
  2748.  
  2749.               IMAIL checks the file, it is unaccessed; the mailer  accesses
  2750.               the file and transfers it; IMAIL tries to access the file and
  2751.               gets a sharing violation; the mailer truncuates the file, but
  2752.               IMAIL still  tries to  access the  file and  gets an  invalid
  2753.               archive.
  2754.  
  2755.               Use this switch  with caution! If  you are not  running in  a
  2756.               multi-tasking enviornment, it  should not be  used, since  it
  2757.               will leave packets that have not been compressed, and with no
  2758.               corresponding file attach message.
  2759.  
  2760.               Naturally, a later run of IMAIL TOSS (or SCAN) will find  the
  2761.               unprocessed packets and process them into ARCmail.
  2762.  
  2763.  
  2764.         c. SCAN - Scan for Outgoing Mail
  2765.  
  2766.            This enables the echo/net mail  SCAN function. The QuickBBS  (or
  2767.            RemoteAccess) message base will be searched for outgoing net and
  2768.            echo mail, exporting it to packets.
  2769.  
  2770.            If the messages are  echo mail, a packet  will be generated  for
  2771.            each of the downlinks listed for  the area; a net mail  message,
  2772.            on the other  hand, will be  exported to a  MSG-style file,  and
  2773.            placed in your net mail directory, where it can be packed routed
  2774.            and compressed with IMPACK - IMAIL will not compress it.
  2775.  
  2776.            For echo mail, if the destination  system is listed in the  Node
  2777.            Manager, the appropriate compression  program will be called  to
  2778.            compress the packet; otherwise, the first program listed will be
  2779.            used (by default, ARC).
  2780.  
  2781.            Regarding echo  mail,  SCAN  will  use  the  origin  address  as
  2782.            specified in the  IMSETUP Area  Manager, rather  than trying  to
  2783.            extract this information from the  message header. This is  done
  2784.            because the QuickBBS  message structure does  not allow for  the
  2785.            zone field to be a number greater than 255.
  2786.  
  2787.  
  2788.            1) /F - Force Complete SCAN
  2789.  
  2790.               If for any reason you suspect that IMAIL has not scanned  out
  2791.               all the the mail which should be exported, run it with the /F
  2792.  
  2793.     ════════════════════════════════════════════════════════════════════════
  2794.     (C) Fabiano Fabris 1990, 1991                                    Page 36
  2795.     ════════════════════════════════════════════════════════════════════════
  2796.  
  2797.     ════════════════════════════════════════════════════════════════════════
  2798.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2799.     ════════════════════════════════════════════════════════════════════════
  2800.  
  2801.  
  2802.               switch. This will bypass the  use of the ECHOMAIL.BBS  and/or
  2803.               NETMAIL.BBS files generated by the BSS and/or message editor,
  2804.               as well as the internal counter  IMAIL uses to keep track  of
  2805.               which message it last scanned.
  2806.  
  2807.  
  2808.            2) /X - No Compression
  2809.  
  2810.               The /X switch will  force SCAN to  not compress any  outgoing
  2811.               packets it has created.
  2812.  
  2813.               For a detailed explanation of this, see the /X switch as used
  2814.               in TOSS (Section b. above).
  2815.  
  2816.  
  2817.         d. ALNK - AreaLink
  2818.  
  2819.            This parameter calls the IMAIL AreaLink function to scan the net
  2820.            mail message  area for  requests. For  more information  on  how
  2821.            AreaLink works, see Chapter 8.
  2822.  
  2823.            Please note that the AreaLink function is automatically  invoked
  2824.            after every run of the TOSS  command, unless you specify the  /N
  2825.            (No AreaLink) switch.
  2826.  
  2827.            AreaLink can also be run specifying switches on the command line
  2828.            (Registered versions only!). For  more information, see  Chapter
  2829.            8. Section g.
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.     ════════════════════════════════════════════════════════════════════════
  2859.     (C) Fabiano Fabris 1990, 1991                                    Page 37
  2860.     ════════════════════════════════════════════════════════════════════════
  2861.  
  2862.     ════════════════════════════════════════════════════════════════════════
  2863.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2864.     ════════════════════════════════════════════════════════════════════════
  2865.  
  2866.  
  2867.      7. IMPACK - Pack Net Mail Messages
  2868.  
  2869.         This calls IMAIL's  packer. The  IMAIL Net  Mail Message  Directory
  2870.         will be  searched for  outgoing net  mail messages,  which will  be
  2871.         compressed  into  ARCmail   compressed  files   according  to   the
  2872.         information given on  the command  line, and  specified in  IMSETUP
  2873.         (see Chapter 5. Section f.).
  2874.  
  2875.         Note that this  command operates  only on MSG  style messages.  Net
  2876.         mail messages in the QuickBBS message base will be exported by  the
  2877.         SCAN command and thereafter treated as normal net mail.
  2878.  
  2879.         The syntax of IMPACK is:
  2880.  
  2881.            IMPACK [z:n/nd[.p] [[...]
  2882.                   VIA z:n/nd[.p]]]
  2883.                   [/N]
  2884.                   [/C]
  2885.                   [/D]
  2886.                   [/H]
  2887.                   [/R]
  2888.  
  2889.         (The  square  brackets   enclose  optional  elements.)   'z:n/nd.p'
  2890.         represents a network address in the usual form:
  2891.  
  2892.            zone:net/node.point
  2893.  
  2894.         where the  point  field is  optional.  If not  specified,  messages
  2895.         addressed to point of  the given system will  be packed along  with
  2896.         the mail for that system.  If you are a  "boss" node, net mail  for
  2897.         your points  will never  be pack  routed via  another node,  unless
  2898.         explicitly forced with the ".ALL" macro (see below).
  2899.  
  2900.         As with IMSETUP,  the net, node  and point fields  may be  replaced
  2901.         with the 'ALL' macro. If you omit the zone field, the zone  defined
  2902.         for your primary network address will be used by default.
  2903.  
  2904.         If more than one  system is given on  the command line, then  there
  2905.         MUST be a 'via' node; that is, a system for which all the mail  for
  2906.         the preceding systems will be packed. Therefore, a command such as:
  2907.  
  2908.            IMPACK 2:ALL 5:ALL 2:2/1
  2909.  
  2910.         is not valid, and IMAIL will complain. Similarly, remember that  if
  2911.         you write
  2912.  
  2913.            IMPACK ALL
  2914.  
  2915.         you are specifying more than one system, in which case, there  must
  2916.         be a 'via' node.
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.     ════════════════════════════════════════════════════════════════════════
  2924.     (C) Fabiano Fabris 1990, 1991                                    Page 38
  2925.     ════════════════════════════════════════════════════════════════════════
  2926.  
  2927.     ════════════════════════════════════════════════════════════════════════
  2928.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2929.     ════════════════════════════════════════════════════════════════════════
  2930.  
  2931.  
  2932.         When run, IMPACK will  scan the command  line for routing  commands
  2933.         and act on them,  after which it will  process the default  routing
  2934.         commands given in IMSETUP,  which means that  you may override  the
  2935.         defaults. If no parameters  are given on  the command line,  IMPACK
  2936.         will simply act on the defaults.
  2937.  
  2938.         For example, the command:
  2939.  
  2940.            IMPACK 2:ALL 5:ALL VIA 2:2/1
  2941.  
  2942.         will collect any outgoing messages for  all systems in zones 2  and
  2943.         5, as well  as messages for  2:2/1, and compress  them into a  file
  2944.         attach for 2:2/1.
  2945.  
  2946.         Please note that by default mail  for points will always be  routed
  2947.         via the boss system. Therefore the commands
  2948.  
  2949.            IMPACK 2:230/41.ALL
  2950.  
  2951.         and
  2952.  
  2953.            IMPACK 2:230/41
  2954.  
  2955.         are equivalent. In both cases all mail for the system 2:230/41  and
  2956.         any of its points will be compressed into the same file.
  2957.  
  2958.         As another example, you may specify:
  2959.  
  2960.            IMPACK ALL VIA 2:2/1
  2961.  
  2962.         If your primary  zone is 2,  this will pack  all outgoing mail  for
  2963.         systems in zone 2 via the system 2:2/1.
  2964.  
  2965.         If you are a "boss" node (that  is, you have points), net mail  for
  2966.         points can only be pack routed explicitly. For example:
  2967.  
  2968.            IMPACK 2:230/100.ALL VIA 2:230/100.1
  2969.  
  2970.         This applies  also  to default  pack  routing. Also  note  that  it
  2971.         applies only  to  4D  addressing (addresses  which  use  the  point
  2972.         number); fake net addresses will not be checked, so care should  be
  2973.         taken that net  mail destined to  a fakenet address  is never  pack
  2974.         routed out of your point net.
  2975.  
  2976.         Messages marked as Crash or Hold will only be processed and  packed
  2977.         if the  /C  and/or /H  switches  (described below)  are  specified.
  2978.         Messages which are file  attaches, file requests, update  requests,
  2979.         or which have the IMMediate, DIRect or LOCKed status will NEVER  be
  2980.         packed.
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.     ════════════════════════════════════════════════════════════════════════
  2989.     (C) Fabiano Fabris 1990, 1991                                    Page 39
  2990.     ════════════════════════════════════════════════════════════════════════
  2991.  
  2992.     ════════════════════════════════════════════════════════════════════════
  2993.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  2994.     ════════════════════════════════════════════════════════════════════════
  2995.  
  2996.  
  2997.         a. /N - No Default Pack Routing
  2998.  
  2999.            If for any reason you wish  IMPACK to ignore the defaults  given
  3000.            in IMSETUP, suffix the  switch /N to the  command line. In  this
  3001.            case, IMPACK will simply process the command line.
  3002.  
  3003.            Note that the command
  3004.  
  3005.               IMPACK /N
  3006.  
  3007.            effectively tells IMPACK to do nothing, since no route  commands
  3008.            are given in the command line, and the /N switch tells IMPACK to
  3009.            ignore the defaults.
  3010.  
  3011.  
  3012.         b. /C - Pack Crash Messages
  3013.  
  3014.            If you want IMPACK  to pack messages  marked with Crash  status,
  3015.            specify the /C switch on the command line.
  3016.  
  3017.            Otherwise, IMPACK will by default NOT pack Crash messages.
  3018.  
  3019.  
  3020.         c. /D - Pack Direct Messages
  3021.  
  3022.            If you specify this switch, IMPACK will pack messages which  are
  3023.            marked as Direct. By default, such messages are not packed.
  3024.  
  3025.            NOTE: messages marked as direct  will not be routed, unless  the
  3026.            /R switch is also specified (see below). So for example, if  you
  3027.            have a message addressed to  2:310/11, and it is marked  direct,
  3028.            you cannot pack route it with the command
  3029.  
  3030.               IMPACK 2:all via 2:310/0
  3031.  
  3032.            Without the /R switch,  direct messages will  only be packed  if
  3033.            "routed" to their destination. For example:
  3034.  
  3035.               IMPACK 2:310/11
  3036.  
  3037.  
  3038.         d. /H - Pack Hold Messages
  3039.  
  3040.            If you want to pack messages marked as Hold along with  "normal"
  3041.            messages, specify the /H switch on the command line.
  3042.  
  3043.            Normally, IMPACK will not pack messages with the Hold bit set.
  3044.  
  3045.  
  3046.         e. /R - Pack Route Direct
  3047.  
  3048.            If you specify the /D switch (see above), net mail messages will
  3049.            not be  pack  routed  unless  they are  being  packed  to  their
  3050.  
  3051.  
  3052.  
  3053.     ════════════════════════════════════════════════════════════════════════
  3054.     (C) Fabiano Fabris 1990, 1991                                    Page 40
  3055.     ════════════════════════════════════════════════════════════════════════
  3056.  
  3057.     ════════════════════════════════════════════════════════════════════════
  3058.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3059.     ════════════════════════════════════════════════════════════════════════
  3060.  
  3061.  
  3062.            destination. This behavior can be overridden with the /R switch.
  3063.            In this case, IMPACK will pack  route net mail marked as  Direct
  3064.            as though this flag had not been specified.
  3065.  
  3066.            Use this  switch  with care,  since  the Direct  flag  is  =not=
  3067.            stripped from the net mail message, and might cause your  uplink
  3068.            considerable grief! Please check  with your uplink before  using
  3069.            it!
  3070.  
  3071.            Note that if the /D switch is =not= specified, this switch  will
  3072.            have no effect.
  3073.  
  3074.  
  3075.         f. /? - Help
  3076.  
  3077.            If you do not give IMPACK any parameters, or if you specify  the
  3078.            /? switch, it will display a brief summary of its options.
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.     ════════════════════════════════════════════════════════════════════════
  3119.     (C) Fabiano Fabris 1990, 1991                                    Page 41
  3120.     ════════════════════════════════════════════════════════════════════════
  3121.  
  3122.     ════════════════════════════════════════════════════════════════════════
  3123.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3124.     ════════════════════════════════════════════════════════════════════════
  3125.  
  3126.  
  3127.      8. AREALINK
  3128.  
  3129.         AreaLink is a function which allows other systems to request  echos
  3130.         from your system without the need  for you to manually insert  them
  3131.         in the areas'  export list. It  is similar in  function to  AreaMgr
  3132.         (which is part of TosScan), or to AreaFix.
  3133.  
  3134.         What happens is this: a system  sends a message addressed to  IMAIL
  3135.         on your system. Instead  of the subject, he  places a password.  In
  3136.         the body of  the message will  go the  list of areas  to which  the
  3137.         other system  wishes to  be linked,  or areas  which he  no  longer
  3138.         wishes to receive.  The system  may also  request information  from
  3139.         IMAIL by including one or more of the supported meta-commands.
  3140.  
  3141.         In order to be able  to use AreaLink, a  system must be defined  in
  3142.         your Node Manager (See section e. of Chapter 5.). When the  request
  3143.         is processed by AreaLink, it will check that the password given  on
  3144.         the subject line of the message matches the one defined in the node
  3145.         manager.
  3146.  
  3147.         Also, AreaLink will only allow a system to request areas  belonging
  3148.         to one of the groups to which he has access.
  3149.  
  3150.  
  3151.         a. Format of the Request
  3152.  
  3153.            As outlined  above,  a  request to  AreaLink  takes  a  specific
  3154.            format. Here is an example:
  3155.  
  3156.               From:    John Doe on 2:230/40
  3157.               To:      IMAIL on 2:230/0
  3158.               Subject: password
  3159.               ---------------------------------------------------
  3160.               +SYSOP              <= Request to add area
  3161.               +NEWS               <= Request to add area
  3162.               -PENPAL             <= Request to remove area
  3163.               ~FRIENDS            <= Request for remote deletion
  3164.               #OLD.ECH : NEW.ECH  <= Request for name change
  3165.               %query              <= Request for active area list
  3166.               %list               <= Request for available area list
  3167.               %unlinked           <= Request for unlinked but available
  3168.                                      areas
  3169.               %rescan             <= Request to rescan new areas
  3170.               %help               <= Request for help on AreaLink use
  3171.  
  3172.            All names, the  password, area  names and  meta-commands may  be
  3173.            given in any combination of upper and lower case.
  3174.  
  3175.            As can be seen, in order to  request that an area be added,  the
  3176.            name of the area may be prefixed with a plus ('+') sign, whereas
  3177.            to have a area removed, it =must= be prefixed with a minus ('-')
  3178.            sign. The plus sign is optional.
  3179.  
  3180.  
  3181.  
  3182.  
  3183.     ════════════════════════════════════════════════════════════════════════
  3184.     (C) Fabiano Fabris 1990, 1991                                    Page 42
  3185.     ════════════════════════════════════════════════════════════════════════
  3186.  
  3187.     ════════════════════════════════════════════════════════════════════════
  3188.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3189.     ════════════════════════════════════════════════════════════════════════
  3190.  
  3191.  
  3192.            The '~' character indicates a remote deletion request; for  more
  3193.            information, see Section e. below. The '#' character indicates a
  3194.            request to change the name of an echo area; this is described in
  3195.            Section f. The  '%', on the  other hand, is  used to prefix  the
  3196.            meta-commands recognized  by AreaLink;  these are  described  in
  3197.            Section b.
  3198.  
  3199.            Note that requests may be addressed to any one of:
  3200.               IMAIL
  3201.               AREALINK
  3202.               AREAFIX
  3203.               AREAMGR
  3204.            AreaLink will recognize any of the above "names".
  3205.  
  3206.            Optionally, the message may end in a tear line ('---'), followed
  3207.            by any text (usually a message to the sysop). In this case,  the
  3208.            request will not  be deleted.  If the message  contains no  tear
  3209.            line, it will be removed once processed.
  3210.  
  3211.  
  3212.         b. Meta-Commands
  3213.  
  3214.            IMAIL supports several meta-commands in AreaLink requests. These
  3215.            are:
  3216.  
  3217.  
  3218.            1) %ALL
  3219.  
  3220.               The %ALL meta-command may be used to link or unlink all areas
  3221.               available to the requesting system. It is used in one of  two
  3222.               ways:
  3223.  
  3224.                  +%ALL   Links all available areas
  3225.                  -%ALL   Unlinks all linked areas
  3226.  
  3227.               This meta-command  may be  combined  with the  "normal"  link
  3228.               requests to form a  request for all areas  except one or  two
  3229.               specific ones (or vice versa). For example:
  3230.  
  3231.                  +%ALL
  3232.                  -SIG.JUNK
  3233.  
  3234.               will link all areas available except for the SIG.JUNK echo.
  3235.  
  3236.               Note that if %RESCAN (see below) is given in the same message
  3237.               as a +%ALL, all the newly linked echos will be rescaned.
  3238.  
  3239.  
  3240.            2) %FROM (R)
  3241.  
  3242.               On registered copies  of IMAIL, the  %FROM meta-command  will
  3243.               allow another  system  to  make requests  "on  behalf"  of  a
  3244.               different system.  This  is particularly  useful  for  remote
  3245.  
  3246.  
  3247.  
  3248.     ════════════════════════════════════════════════════════════════════════
  3249.     (C) Fabiano Fabris 1990, 1991                                    Page 43
  3250.     ════════════════════════════════════════════════════════════════════════
  3251.  
  3252.     ════════════════════════════════════════════════════════════════════════
  3253.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3254.     ════════════════════════════════════════════════════════════════════════
  3255.  
  3256.  
  3257.               maintenance of someone  else's system. In  order to do  this,
  3258.               the system have Remote Maint enabled in IMSETUP (see  Chapter
  3259.               5. section e.).
  3260.  
  3261.               The format of the meta-command is
  3262.  
  3263.                  %FROM <full node number>
  3264.  
  3265.               where the address must include  the zone and point fields  of
  3266.               the system which will be linked (or unlinked).
  3267.  
  3268.               Note that  the  password (subject)  of  the message  must  be
  3269.               correct for  the  system SENDING  the  message, not  for  the
  3270.               system for  which the  changes will  be made.  The  generated
  3271.               reply will  be send,  again,  to the  system which  sent  the
  3272.               request, not to the one for which the changes were made.
  3273.  
  3274.  
  3275.            3) %HELP
  3276.  
  3277.               This meta-command will make AreaLink send a help text to  the
  3278.               sysop. The help text to be sent may be defined in IMSETUP; if
  3279.               none is defined, a standard text will be sent, explaining the
  3280.               principle features of AreaLink.
  3281.  
  3282.  
  3283.            4) %LIST
  3284.  
  3285.               The %LIST meta-command will have  AreaLink reply with a  list
  3286.               of all the areas available to the requesting system. In other
  3287.               words, those which are marked as Active, and which belong  to
  3288.               a group listed as available for that system.
  3289.  
  3290.  
  3291.            5) %QUERY
  3292.  
  3293.               If the  message  contains this  meta-command,  AreaLink  will
  3294.               reply  with  a  list  of  currently  active  echos  for   the
  3295.               requesting system
  3296.  
  3297.  
  3298.            6) %RESCAN
  3299.  
  3300.               This meta-command will  allow a  node to  request that  IMAIL
  3301.               send all old mail in the  areas requested. For example, if  a
  3302.               system requests to be linked to the SYSOP echo, and places  a
  3303.               %RESCAN meta-command in the message text, IMAIL will link the
  3304.               system, and then scan your  message base for any messages  in
  3305.               this area, and send them to the requesting system.
  3306.  
  3307.               All the exported messages will have the same SEEN-BY lines as
  3308.               they normally would, thus (hopefully) preventing  duplicates.
  3309.               However, the messages  will be  exported only  to the  system
  3310.               requesting the rescan, not to all linked nodes.
  3311.  
  3312.  
  3313.     ════════════════════════════════════════════════════════════════════════
  3314.     (C) Fabiano Fabris 1990, 1991                                    Page 44
  3315.     ════════════════════════════════════════════════════════════════════════
  3316.  
  3317.     ════════════════════════════════════════════════════════════════════════
  3318.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3319.     ════════════════════════════════════════════════════════════════════════
  3320.  
  3321.  
  3322.               In order to  prevent the  system which  requested the  rescan
  3323.               from sending the messages out to other systems, AreaLink will
  3324.               insert a special kludge into the message: ^ARESCANNED
  3325.  
  3326.               Note that if you have set the Allow Rescan option in  IMSETUP
  3327.               to "no" (see Chapter 5. Section 4)), then the rescan  request
  3328.               will be ignored.
  3329.  
  3330.  
  3331.            7) %UNLINKED
  3332.  
  3333.               This meta-command is,  in a sense,  the complement of  %QUERY
  3334.               and %LIST.  In  other words,  it  will  send a  list  of  all
  3335.               available  echos  which  are  NOT  currently  linked  to  the
  3336.               requesting system.
  3337.  
  3338.  
  3339.         c. AreaLink Replies
  3340.  
  3341.            When it has processed a request, AreaLink will generate a  reply
  3342.            message to the system  who sent the  request. This message  will
  3343.            contain the list  of echo  areas added and/or  removed for  that
  3344.            system, as well as query and list information, if indicated.
  3345.  
  3346.            The message will be marked as  Kill/Sent (ie it will be  deleted
  3347.            once sent) unless you  have configured IMAIL  to keep them  (see
  3348.            Chapter 5. Section 4)).
  3349.  
  3350.  
  3351.         d. Forward Link Requests (R)
  3352.  
  3353.            Registered users  of IMAIL  may define  one or  more systems  as
  3354.            uplinks, specifying the name of a file containing a list of echo
  3355.            areas available on those systems.
  3356.  
  3357.            If a system  requests an  echo area not  currently available  on
  3358.            your system, AreaLink  will search the  files specified for  the
  3359.            required echo. If it is found, it will generate a request to the
  3360.            given uplink. In this case,  it will also automatically add  the
  3361.            area to your database, defining the area name, and marking it as
  3362.            passthrough (as opposed to  areas automatically added by  TOSS);
  3363.            the group will  be undefined.  The uplink  and downlink  systems
  3364.            will be defined in the export list. Such areas will be marked as
  3365.            "Auto-Added" in the IMSETUP Area Manager until they are edited.
  3366.  
  3367.  
  3368.         e. Remote Deletion (R)
  3369.  
  3370.            AreaLink will allow you  to give partial  control of your  areas
  3371.            configuration to  another system:  any system  which has  Remote
  3372.            Maint (see Chapter 5.  Section e.) enabled  in the Node  Manager
  3373.            will be able to delete one or more echo areas from your  system.
  3374.            This feature is useful if, for  example, you wish to allow  your
  3375.            boss or host system to automatically delete an area when it  has
  3376.            been discontinued.
  3377.  
  3378.     ════════════════════════════════════════════════════════════════════════
  3379.     (C) Fabiano Fabris 1990, 1991                                    Page 45
  3380.     ════════════════════════════════════════════════════════════════════════
  3381.  
  3382.     ════════════════════════════════════════════════════════════════════════
  3383.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3384.     ════════════════════════════════════════════════════════════════════════
  3385.  
  3386.  
  3387.            In order for a system to delete an area from your list, it  will
  3388.            send a normal  AreaLink request  to your  system, prefixing  the
  3389.            names of  the areas  to be  deleted with  a '~'  character.  For
  3390.            example:
  3391.  
  3392.               From:    John Doe on 2:230/40
  3393.               To:      IMAIL on 2:230/0
  3394.               Subject: password
  3395.               ---------------------------------------------------
  3396.               SYSOP               <= Request to add area
  3397.               ~PENPAL             <= Request to delete area
  3398.  
  3399.            In the above example, the system  is requesting that an area  be
  3400.            linked to it,  and at  the same time,  that the  area PENPAL  be
  3401.            deleted from your configuration.
  3402.  
  3403.            When AreaLink processes such a request, it will first send a net
  3404.            mail message to any other systems which are linked to that area,
  3405.            warning them that  it has been  deleted. It will  then flag  the
  3406.            area as deleted and inactive, so that any requests to link to it
  3407.            will be ignored.  The next  time IMSETUP  is run,  and the  Area
  3408.            Manager entered, the  area will be  removed completely from  the
  3409.            list.
  3410.  
  3411.  
  3412.         f. Remote Change (R)
  3413.  
  3414.            As with  Remote  Deletion  requests (see  previous  section),  a
  3415.            system which  has Remote  Maint privileges  on your  system  may
  3416.            request a change of  area name. What this  will do is simply  to
  3417.            change the  name of  the  area; no  other variations  will  take
  3418.            place.
  3419.  
  3420.            The format of a Remote Change request is as follows:
  3421.  
  3422.               From:    John Doe on 2:230/40
  3423.               To:      IMAIL on 2:230/0
  3424.               Subject: password
  3425.               ---------------------------------------------------
  3426.               SYSOP               <= Request to add area
  3427.               #OLD.ECH : NEW.CH   <= Request to change name
  3428.  
  3429.            The '#' character indicates  a Change request. Following  should
  3430.            be the old area name; then, after the ':' character should  come
  3431.            the new area name.  The spaces before and  after the ':' may  be
  3432.            omitted.
  3433.  
  3434.            If AreaLink finds the old area name, and the node requesting the
  3435.            change  is  active  for  that  group,  AreaLink  will  make  the
  3436.            requested change, advising all other downlinks of the  variation
  3437.            by sending them a net mail message.
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.     ════════════════════════════════════════════════════════════════════════
  3444.     (C) Fabiano Fabris 1990, 1991                                    Page 46
  3445.     ════════════════════════════════════════════════════════════════════════
  3446.  
  3447.     ════════════════════════════════════════════════════════════════════════
  3448.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3449.     ════════════════════════════════════════════════════════════════════════
  3450.  
  3451.  
  3452.         g. Local Maintainance (R)
  3453.  
  3454.            Registered copies of IMAIL will allow the sysop to use  AreaLink
  3455.            as if another  sysop had  sent a request.  This can  be done  by
  3456.            using one or more of the command line switches described below.
  3457.  
  3458.            When run from the  command line, AreaLink  is designed to  mimic
  3459.            its behavior when it is  parsing a request from another  system.
  3460.            (For more information on  the single meta-commands, see  Section
  3461.            b. above.)  The  advantage of  using  AreaLink to  make  changes
  3462.            instead of doing it from IMSETUP is that a net mail message will
  3463.            be generated automatically, informing the system of the  changes
  3464.            made.
  3465.  
  3466.            Note that each switch may appear only ONCE on the command  line.
  3467.            However, the meta-command %ALL  may be used with  the /+ and  /-
  3468.            switches. For  multiple changes,  it will  be necessary  to  run
  3469.            AreaLink several times.
  3470.  
  3471.            The complete syntax accepted by AreaLink is:
  3472.  
  3473.               IMAIL ALNK /N<addr>
  3474.                          /+<area>
  3475.                          /-<area>
  3476.                          /L
  3477.                          /Q
  3478.                          /U
  3479.                          /R
  3480.                          /H
  3481.                          /D<area>
  3482.                          /C<area:area>
  3483.  
  3484.  
  3485.            1) /N<address> - Node to Make Changes For
  3486.  
  3487.               This switch indicates the node number for which you wish  the
  3488.               changes to be made. It will make AreaLink behave as it it had
  3489.               received a request from  that system, sending  it a net  mail
  3490.               messages listing the actions taken.
  3491.  
  3492.               If this parameter is omitted, AreaLink will act on behalf  of
  3493.               YOUR system. Thus most of the other switches are meaningless.
  3494.               In particular, /L, /Q, /H /U, /R, /+ and /- will be ignored.
  3495.  
  3496.               If the  /N  switch  is  used, a  net  mail  message  will  be
  3497.               generated for that  system, specifying the  changes made.  If
  3498.               this switch is NOT used, a net mail message will be generated
  3499.               to you.
  3500.  
  3501.  
  3502.            2) /+<area> - Link Node to Area
  3503.  
  3504.               Links the system specified by /N  to the echo area. If /N  is
  3505.               not specified, this switch will be ignored.
  3506.  
  3507.  
  3508.     ════════════════════════════════════════════════════════════════════════
  3509.     (C) Fabiano Fabris 1990, 1991                                    Page 47
  3510.     ════════════════════════════════════════════════════════════════════════
  3511.  
  3512.     ════════════════════════════════════════════════════════════════════════
  3513.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3514.     ════════════════════════════════════════════════════════════════════════
  3515.  
  3516.  
  3517.            3) /-<area> - Unlink Node from Area
  3518.  
  3519.               Unlinks the system specified by /N from the given echo  area.
  3520.               If /N is not specified, this switch will have no effect.
  3521.  
  3522.  
  3523.            4) /L - List Available Areas
  3524.  
  3525.               Sends the system  a list  of available  echos, marking  those
  3526.               which are already linked. This switch is ignored if /N is not
  3527.               given. (Corresponds to the %LIST meta-command.)
  3528.  
  3529.  
  3530.            5) /Q - Query - List Linked Echos
  3531.  
  3532.               Sends the system a list of currently linked echos. The switch
  3533.               is ignored  if no  system is  specified with  the /N  switch.
  3534.               (Corresponds to the %QUERY meta-command.)
  3535.  
  3536.  
  3537.            6) /U - List Available but Unlinked Echos
  3538.  
  3539.               Sends a  list  of echo  areas  which are  available  but  not
  3540.               currently linked to the system. The switch will be ignored if
  3541.               no system is specified with /N. (Corresponds to the %UNLINKED
  3542.               meta-command.)
  3543.  
  3544.  
  3545.            7) /R - Rescan
  3546.  
  3547.               Perform a rescan of echos linked with /+. This switch has  no
  3548.               meaning if /+ and /N are both not specified. (Corresponds  to
  3549.               the %RESCAN meta-command.)
  3550.  
  3551.  
  3552.            8) /H - Send Help
  3553.  
  3554.               Sends the system the  defined help text.  This switch has  no
  3555.               meaning if  no  system  is  specified  with  the  /N  switch.
  3556.               (Corresponds to the %HELP meta-command.)
  3557.  
  3558.  
  3559.            9) /D<area> - Delete Echo Area
  3560.  
  3561.               Deletes the specified echo area.  All links will be  notified
  3562.               of the deletion. (Switch may be substituted with /~<area>)
  3563.  
  3564.  
  3565.            10) /C<area:area> - Change Echo Name
  3566.  
  3567.               Changes the name of an echo. The first echo tag is changed to
  3568.               the second. (Switch may be substituted with /#<area:area>)
  3569.  
  3570.  
  3571.  
  3572.  
  3573.     ════════════════════════════════════════════════════════════════════════
  3574.     (C) Fabiano Fabris 1990, 1991                                    Page 48
  3575.     ════════════════════════════════════════════════════════════════════════
  3576.  
  3577.     ════════════════════════════════════════════════════════════════════════
  3578.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3579.     ════════════════════════════════════════════════════════════════════════
  3580.  
  3581.  
  3582.      9. AUTOMATIC MESSAGE REPLIES (R)
  3583.  
  3584.         If enabled via  IMSETUP (see  chapter 5., Section  a.), IMAIL  will
  3585.         generate automatic replies for  messages that have remained  unread
  3586.         for more than the specified number of days.
  3587.  
  3588.         In order to "qualify", a message must be addressed to you (the name
  3589.         defined in the  Sysop field  in IMSETUP)  or to  'Sysop', and  must
  3590.         originate from another system.
  3591.  
  3592.         Generally, IMAIL  will  submit  a  standard  message.  However,  if
  3593.         specified, it  can use  a special  text file  when it  generates  a
  3594.         message. This text  file may  contain one  or more  macros, of  the
  3595.         form:
  3596.  
  3597.            %macro%
  3598.  
  3599.         They  are  explained  below.  For  a  sample  text,  see  the  file
  3600.         IM_REPLY.TXT included in the distribution archive. Please note that
  3601.         if a macro is enclosed in double quotes, it will NOT be parsed, but
  3602.         will be repeated as it is.
  3603.  
  3604.  
  3605.         a. %of%
  3606.  
  3607.            Your first name, as defined in IMSETUP.
  3608.  
  3609.  
  3610.         b. %ol%
  3611.  
  3612.            Your last name, as defined in IMSETUP.
  3613.  
  3614.  
  3615.         c. %os%
  3616.  
  3617.            Your primary system address.
  3618.  
  3619.  
  3620.         d. %df%
  3621.  
  3622.            Destination user's first name.
  3623.  
  3624.  
  3625.         e. %dl%
  3626.  
  3627.            Destination user's last name.
  3628.  
  3629.  
  3630.         f. %ds%
  3631.  
  3632.            Destination user's system address.
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.     ════════════════════════════════════════════════════════════════════════
  3639.     (C) Fabiano Fabris 1990, 1991                                    Page 49
  3640.     ════════════════════════════════════════════════════════════════════════
  3641.  
  3642.     ════════════════════════════════════════════════════════════════════════
  3643.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3644.     ════════════════════════════════════════════════════════════════════════
  3645.  
  3646.  
  3647.         g. %mt%
  3648.  
  3649.            Time of the message for which the reply is being generated.
  3650.  
  3651.  
  3652.         h. %md%
  3653.  
  3654.            Date of the message for which the reply is being generated.
  3655.  
  3656.  
  3657.         i. %at%
  3658.  
  3659.            Current time.
  3660.  
  3661.  
  3662.         j. %ad%
  3663.  
  3664.            Current date.
  3665.  
  3666.  
  3667.         k. %dy%
  3668.  
  3669.            Number of days for which the message has been "sitting" unread.
  3670.  
  3671.  
  3672.         l. %im%
  3673.  
  3674.            IMAIL signature.
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.  
  3694.  
  3695.  
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.     ════════════════════════════════════════════════════════════════════════
  3704.     (C) Fabiano Fabris 1990, 1991                                    Page 50
  3705.     ════════════════════════════════════════════════════════════════════════
  3706.  
  3707.     ════════════════════════════════════════════════════════════════════════
  3708.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3709.     ════════════════════════════════════════════════════════════════════════
  3710.  
  3711.  
  3712.      10. IMTHINGS
  3713.  
  3714.         IMTHINGS is a program containing additional utilities for use  with
  3715.         IMAIL. It is used  giving it a  command and additional  parameters,
  3716.         which vary according to the command given.
  3717.  
  3718.         All of the commands give a brief on-line help if followed by the /?
  3719.         switch. For example, to get help on the SEND command:
  3720.  
  3721.            IMTHINGS SEND /?
  3722.  
  3723.         In most  cases, the  commands  may be  abbreviated  to one  or  two
  3724.         letters; for example IMTHINGS KILL may be given as IMTHINGS K.
  3725.  
  3726.         However, IMTHINGS STAT must be abbreviated to IMTHINGS ST since the
  3727.         SEND command also begin with the letter 'S'.
  3728.  
  3729.  
  3730.         a. IMPORT - Import Net Mail Messages
  3731.  
  3732.            The IMPORT function allows you to import net mail messages  from
  3733.            the net mail directory into  the QuickBBS message base. This  is
  3734.            necessary is you wish to allow the users of your BBS to read net
  3735.            mail addressed to them.
  3736.  
  3737.            This command  has  no parameters.  It  will scan  the  net  mail
  3738.            directory for net mail messages  addressed to one of your  AKAs,
  3739.            and if  found,  import  them  into  the  net  mail  board  which
  3740.            corresponds to that  AKA. Once  imported, the MSG  file will  be
  3741.            deleted. Note that net mail addressed to the name listed in  the
  3742.            Sysop field,  or  to  any  of  "IMAIL",  "AREALINK",  "AREAMGR",
  3743.            "AREAFIX" or "SYSOP" will  =not= be imported  into the net  mail
  3744.            board(s).
  3745.  
  3746.            NOTE: net mail messages which  are also File Requests or  Update
  3747.            Requests will  not be  imported. However,  File Attach  messages
  3748.            will. So to avoid problems, it is best to run IMAIL TOSS  before
  3749.            IMTHINGS IMPORT.
  3750.  
  3751.  
  3752.         b. INDEX - Rebuild index files
  3753.  
  3754.            The INDEX  command will  rebuild the  message base  index  files
  3755.            (MSGIDX.BBS, MSGTOIDX.BBS and  MSGINFO.BBS) from the  MSGHDR.BBS
  3756.            file. Use this if for any reason you suspect that one or more of
  3757.            these files have somehow become damaged.
  3758.  
  3759.            Note  that  INDEX  is  run  automatically  after  the  following
  3760.            functions:
  3761.  
  3762.               MOVE
  3763.               SORT
  3764.  
  3765.            The INDEX function has no command line parameters.
  3766.  
  3767.  
  3768.     ════════════════════════════════════════════════════════════════════════
  3769.     (C) Fabiano Fabris 1990, 1991                                    Page 51
  3770.     ════════════════════════════════════════════════════════════════════════
  3771.  
  3772.     ════════════════════════════════════════════════════════════════════════
  3773.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3774.     ════════════════════════════════════════════════════════════════════════
  3775.  
  3776.  
  3777.         c. KILL - Delete messages from an area
  3778.  
  3779.            The KILL  command allows  you to  mark as  deleted some  or  all
  3780.            messages in a specified  message area. Note  that KILL does  NOT
  3781.            pack the message base. Use IMTHINGS PACK for this.
  3782.  
  3783.            Normally, KILL will  create a  temporary file to  which it  will
  3784.            write the new MSGHDR.BBS. However,  if it detects that there  is
  3785.            not enough  disk  space, it  will  overwrite the  original  file
  3786.            directly; this method is MUCH slower.
  3787.  
  3788.            Note that it is  advisable to run IMAIL  SCAN /F before  running
  3789.            this command;  this  will ensure  that  all outgoing  echo  mail
  3790.            messages have been exported.
  3791.  
  3792.            The syntax of the command is:
  3793.  
  3794.               IMTHINGS KILL /A<areaname>
  3795.                             /B<board>
  3796.                             /D<days>
  3797.                             /K<days>
  3798.                             /N<number>
  3799.                             /P
  3800.                             /U
  3801.  
  3802.  
  3803.            1) /A<areaname>
  3804.  
  3805.               If specified, the /A switch should be followed by the name of
  3806.               one of the echo areas, as given in the Area Manager. If  this
  3807.               switch is used, then the /B switch should NOT be given.
  3808.  
  3809.               NOTE: If  you specify  the  /U switch,  this switch  will  be
  3810.               ignored.
  3811.  
  3812.  
  3813.            2) /B<board>
  3814.  
  3815.               If specified, the /B switch  should be followed by a  message
  3816.               board number. In this way, it is possible to "act" on message
  3817.               board not defined in the  IMSETUP Area Manager (for  example,
  3818.               local message areas). If the /B  switch is used, then the  /A
  3819.               switch should NOT be given.
  3820.  
  3821.               If you do not specify one of /A or /B, then KILL will act  on
  3822.               ALL message  boards,  unless  the /U  switch  is  given  (see
  3823.               below).
  3824.  
  3825.  
  3826.            3) /D<days>
  3827.  
  3828.               This allows you  to specify  that KILL  should keep  messages
  3829.               younger than the given number of  days. If the switch is  not
  3830.               used, then IMTHINGS will not check the date of the message.
  3831.  
  3832.  
  3833.     ════════════════════════════════════════════════════════════════════════
  3834.     (C) Fabiano Fabris 1990, 1991                                    Page 52
  3835.     ════════════════════════════════════════════════════════════════════════
  3836.  
  3837.     ════════════════════════════════════════════════════════════════════════
  3838.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3839.     ════════════════════════════════════════════════════════════════════════
  3840.  
  3841.  
  3842.               Note that if the  /U switch is given,  the /D switch will  be
  3843.               ignored.
  3844.  
  3845.  
  3846.            4) /K<days> (R)
  3847.  
  3848.               This switch allows you to have KILL delete old ARCmail  files
  3849.               and their  respective  file attaches.  The  <days>  parameter
  3850.               indicates the age  of the  message; in  other words,  ARCmail
  3851.               files which are older than the  given number of days will  be
  3852.               deleted.
  3853.  
  3854.               If you choose to use this switch, it is recommended that  you
  3855.               advise your downlinks, so that they know that should pick  up
  3856.               their mail before it is deleted.
  3857.  
  3858.               This option  is available  in  registered versions  of  IMAIL
  3859.               only.
  3860.  
  3861.  
  3862.            5) /N<number>
  3863.  
  3864.               If this switch is used, KILL will leave the specified  number
  3865.               of messages in the base, marking the rest as deleted.
  3866.  
  3867.               Note that if neither /N nor /D are specified, then KILL  will
  3868.               mark ALL messages in the designated board as deleted,  unless
  3869.               the /U switch is  given (see below). If  both are given,  the
  3870.               KILL will ensure that both criteria are met, in which case it
  3871.               may leave less than <number> messages in the area if it finds
  3872.               "old" messages.
  3873.  
  3874.  
  3875.            6) /P - Run PACK after KILL
  3876.  
  3877.               If you specify the /P parameter, KILL will automatically  run
  3878.               PACK if any messages were marked as deleted. This can be used
  3879.               with the /U parameter, or with any of the others.
  3880.  
  3881.               Note that once the message base is PACKed, no messages can be
  3882.               recovered.
  3883.  
  3884.  
  3885.            7) /U - Use Default Information
  3886.  
  3887.               This parameter  tells IMTHINGS  KILL to  use the  information
  3888.               given in IMSETUP to determine  how many messages to kill.  It
  3889.               will operate  on all  boards defined  in the  Areas  Manager,
  3890.               leaving the  given  numbers  of messages  in  the  board,  or
  3891.               deleting all messages older than the given number of days.
  3892.  
  3893.               PLEASE NOTE: if you use the /U switch, the /A, /B, /D and  /N
  3894.               switches will be ignored if also specified.
  3895.  
  3896.  
  3897.  
  3898.     ════════════════════════════════════════════════════════════════════════
  3899.     (C) Fabiano Fabris 1990, 1991                                    Page 53
  3900.     ════════════════════════════════════════════════════════════════════════
  3901.  
  3902.     ════════════════════════════════════════════════════════════════════════
  3903.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3904.     ════════════════════════════════════════════════════════════════════════
  3905.  
  3906.  
  3907.         d. LINK - Link Messages in Message Base
  3908.  
  3909.            In order  to update  the links  between the  messages and  their
  3910.            replies, run IMTHINGS LINK after  each arrival of echo mail,  or
  3911.            at least once a night.
  3912.  
  3913.            LINK scans the  message base,  looks for  messages with  similar
  3914.            subject lines, and  from them, creates  links for each  message,
  3915.            which point to the previous message  in the chain, and the  next
  3916.            message.
  3917.  
  3918.            Note that the case of the subject line is not significant;  thus
  3919.            "Echo mail" and "Echo Mail" will match when creating links. Note
  3920.            however that the search is performed ignoring any leading  "RE:"
  3921.            in the subject line.
  3922.  
  3923.            The syntax of this command is:
  3924.  
  3925.               IMTHINGS LINK /C
  3926.  
  3927.  
  3928.            1) /C - Clean
  3929.  
  3930.               If this switch is specified, LINK will remove all occurrences
  3931.               of "RE:"  (in  upper  and/or lower  case)  from  the  message
  3932.               subject lines. Otherwise, the "RE:"  strings will be left  in
  3933.               place, but still ignored when the link search is being done.
  3934.  
  3935.  
  3936.         e. MOVE - Move Message Area
  3937.  
  3938.            The MOVE command allows  you to move all  the messages from  one
  3939.            board (or area) to another. The syntax of the command allows you
  3940.            to specify  the source  and destination  areas either  by  board
  3941.            number or by area name (if it exists).
  3942.  
  3943.               IMTHINGS MOVE /R<src area> | /S<src board>
  3944.                             /T<dst area> | /D<dst board>
  3945.  
  3946.            Please note that all messages moved will have the Outgoing Echo,
  3947.            Outgoing Net and Netmail bits cleared, so that they will not  be
  3948.            SCANned out again  by mistake,  thus creating  confusion in  the
  3949.            network.
  3950.  
  3951.            The  INDEX  function  is   run  automatically  after  MOVE   has
  3952.            terminated.
  3953.  
  3954.  
  3955.            1) /R<src area>
  3956.  
  3957.               If you  know the  area name  as specified  in IMSETUP's  Area
  3958.               Manager, you may  use this  switch. If you  use this  switch,
  3959.               then do NOT use the /B switch.
  3960.  
  3961.               For example:
  3962.  
  3963.     ════════════════════════════════════════════════════════════════════════
  3964.     (C) Fabiano Fabris 1990, 1991                                    Page 54
  3965.     ════════════════════════════════════════════════════════════════════════
  3966.  
  3967.     ════════════════════════════════════════════════════════════════════════
  3968.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  3969.     ════════════════════════════════════════════════════════════════════════
  3970.  
  3971.  
  3972.                  IMTHINGS MOVE /RSYSOP /D12
  3973.  
  3974.               will move all messages from the SYSOP area to board 12 (which
  3975.               might be a local board).
  3976.  
  3977.  
  3978.            2) /S<src board>
  3979.  
  3980.               If the source board is local,  it will have no area name;  so
  3981.               specify the board number using the /S switch. If you use  /S,
  3982.               then do NOT use /R.
  3983.  
  3984.  
  3985.            3) /T<dst area>
  3986.  
  3987.               You may specify the destination  area name with this  switch.
  3988.               It is used in the same way  as /R. If you use the /T  switch,
  3989.               then do NOT use /D.
  3990.  
  3991.  
  3992.            4) /D<dst board>
  3993.  
  3994.               If the destination board is local, it will not be defined  in
  3995.               the Area Manager; so  you may specify  the board number.  See
  3996.               above for an example of its use. If you use this switch, then
  3997.               do NOT use /T.
  3998.  
  3999.  
  4000.         f. NOLINK
  4001.  
  4002.            You should use this function if  you wish to know which of  your
  4003.            echo areas have  0 or  1 link(s).  This will  help you  discover
  4004.            areas which you  may no longer  need, and which  you may  unlink
  4005.            from your feed particularly is they are passthrough areas.
  4006.  
  4007.            The syntax of the command is:
  4008.  
  4009.               IMTHINGS NOLINK /D
  4010.                               /I
  4011.                               /P
  4012.  
  4013.            The list will be shown on the screen, and saved to your log file
  4014.            (if one is defined).
  4015.  
  4016.  
  4017.            1) /D - Mark as Deleted
  4018.  
  4019.               The /D  switch marks  ALL  echos having  0  or 1  link(s)  as
  4020.               deleted. This switch operates on  ALL such areas (but see  /P
  4021.               below), and is not reversible!  In other words, once an  area
  4022.               is marked as deleted, it cannot be recovered in IMSETUP.
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.     ════════════════════════════════════════════════════════════════════════
  4029.     (C) Fabiano Fabris 1990, 1991                                    Page 55
  4030.     ════════════════════════════════════════════════════════════════════════
  4031.  
  4032.     ════════════════════════════════════════════════════════════════════════
  4033.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4034.     ════════════════════════════════════════════════════════════════════════
  4035.  
  4036.  
  4037.            2) /I - Mark as Inactive
  4038.  
  4039.               /I marks as  inactive ALL  echos having  0 or  1 link(s).  An
  4040.               Inactive area behaves just as if it were not defined; if  you
  4041.               receive mail in that  area, it will be  tossed into your  bad
  4042.               message board.
  4043.  
  4044.               The Inactive flag  may be changed  in the area  manager at  a
  4045.               later date, so the use of /I is safer than that of /D.
  4046.  
  4047.  
  4048.            3) /P - Passthrough Only
  4049.  
  4050.               The NOLINK function  is most  useful if you  specify that  it
  4051.               process only areas which are  marked as Passthrough. This  is
  4052.               done by giving the /P switch on the command line.
  4053.  
  4054.  
  4055.         g. NOTIFY - Send list of linked echos
  4056.  
  4057.            The NOTIFY function will send a message to the systems which are
  4058.            linked to you for at least  one echo area, listing the echos  to
  4059.            which they are  linked, as well  as systems listed  in the  Node
  4060.            Manager.
  4061.  
  4062.            The syntax of the command is:
  4063.  
  4064.               IMTHINGS NOTIFY [z:n/nd.p]
  4065.                               [....]
  4066.                               /A
  4067.                               /N
  4068.                               /P
  4069.  
  4070.            where "z:n/nd.p" is a standard network address. The "ALL"  macro
  4071.            may be used,  as with IMPACK  (except, of course,  that in  this
  4072.            case there are no "VIA" nodes). Note that
  4073.  
  4074.               IMTHINGS NOTIFY ALL
  4075.  
  4076.            notifies all systems in your primary zone only. If you have AKAs
  4077.            in different zones or feed echo mail to systems in more than one
  4078.            zone, and wish to notify ALL of your downlinks, simply give  the
  4079.            command
  4080.  
  4081.               IMTHINGS NOTIFY
  4082.  
  4083.  
  4084.            1) /A - List all available areas
  4085.  
  4086.               If you specify  this switch,  NOTIFY will not  only list  the
  4087.               liked conferences, but  will also  send a list  of the  echos
  4088.               which are available to that  system, according to the  groups
  4089.               to which that system has access.
  4090.  
  4091.  
  4092.  
  4093.     ════════════════════════════════════════════════════════════════════════
  4094.     (C) Fabiano Fabris 1990, 1991                                    Page 56
  4095.     ════════════════════════════════════════════════════════════════════════
  4096.  
  4097.     ════════════════════════════════════════════════════════════════════════
  4098.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4099.     ════════════════════════════════════════════════════════════════════════
  4100.  
  4101.  
  4102.            2) /N - No node manager
  4103.  
  4104.               If you  specify  this  switch, NOTIFY  will  not  generate  a
  4105.               message to systems which are listed only in the node manager,
  4106.               but are not listed in any of the echo areas' export lists.
  4107.  
  4108.  
  4109.            3) /P - Notify AreaLink Password
  4110.  
  4111.               If you  wish  to  remind your  downlinks  of  their  AreaLink
  4112.               password, specify the  /P switch. The  password will then  be
  4113.               included in the net mail message which is generated.
  4114.  
  4115.  
  4116.         h. PACK - Compress message base
  4117.  
  4118.            When you delete a message, it  is not actually removed from  the
  4119.            base, but rather  is just marked  in a special  way (thus it  is
  4120.            possible to "undelete"  them - see  the RECOVER command  below).
  4121.            PACK will  allow  you to  remove  from the  message  base  those
  4122.            messages marked as deleted, thus recovering unused disk space.
  4123.  
  4124.            Normally, PACK  will create  temporary files  to which  it  will
  4125.            write the new  MSGHDR.BBS and MSGTXT.BBS  files. However, if  it
  4126.            detects that there is not enough free disk space to do this,  it
  4127.            will overwrite the original  files; this method is  considerably
  4128.            slower.
  4129.  
  4130.            Optionally, it is also  possible to have  PACK renumber all  net
  4131.            mail messages.
  4132.  
  4133.            In order to make PACK  faster, it does not  try to update the  3
  4134.            index files; instead of this, it will call IMTHINGS INDEX  after
  4135.            having completed.
  4136.  
  4137.            Note that it is  advisable to run IMAIL  SCAN /F before  packing
  4138.            the message base. This will  ensure that all outgoing echo  mail
  4139.            messages have been exported.
  4140.  
  4141.            The syntax of the command is:
  4142.  
  4143.               IMTHINGS PACK /B
  4144.                             /R
  4145.  
  4146.            PACK is not able to keep track  of the message links, so it  may
  4147.            be desirable to run LINK after PACK.
  4148.  
  4149.            PACK will update the USERS.BBS file (if it is found) as well  as
  4150.            LASTREAD.BBS (this file keeps track of the last messages read in
  4151.            each message area).
  4152.  
  4153.  
  4154.  
  4155.  
  4156.  
  4157.  
  4158.     ════════════════════════════════════════════════════════════════════════
  4159.     (C) Fabiano Fabris 1990, 1991                                    Page 57
  4160.     ════════════════════════════════════════════════════════════════════════
  4161.  
  4162.     ════════════════════════════════════════════════════════════════════════
  4163.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4164.     ════════════════════════════════════════════════════════════════════════
  4165.  
  4166.  
  4167.            1) /B - Keep backup
  4168.  
  4169.               If you specify this switch, PACK will not delete the  backups
  4170.               it made of the five files which comprise the message base.
  4171.  
  4172.  
  4173.            2) /R - Renumber
  4174.  
  4175.               Giving the /R  switch will  have PACK renumber  all net  mail
  4176.               messages.
  4177.  
  4178.  
  4179.         i. POST - Post message in echo area
  4180.  
  4181.            The POST function will  allow you to post  a message in an  echo
  4182.            area.  It  is  particularly  useful  for  posting  echo  message
  4183.            statistics, for example.
  4184.  
  4185.            The syntax of the command is:
  4186.  
  4187.               IMTHINGS POST /F<filename>
  4188.                             /A<areaname>
  4189.                             /B<board>
  4190.                             /W<to_who>
  4191.                             /R<from_who>
  4192.                             /S<subject>
  4193.  
  4194.  
  4195.            1) /F<filename>
  4196.  
  4197.               The /F switch is used to specify the name of the text file to
  4198.               post as the message. This file should be a simple ASCII file,
  4199.               containing no special control  characters. This parameter  is
  4200.               required.
  4201.  
  4202.  
  4203.            2) /A<areaname>
  4204.  
  4205.               To specify the  name of the  echo area in  which to post  the
  4206.               message, use the /A switch. The name of the area may be given
  4207.               in upper or lower case, or any combination of the two. If you
  4208.               use this switch, do NOT use the /B switch.
  4209.  
  4210.  
  4211.            3) /B<board>
  4212.  
  4213.               Use the /B switch to give the number of the message board  in
  4214.               which to post the  message. If you use  this switch, then  do
  4215.               NOT use the /A switch.
  4216.  
  4217.  
  4218.  
  4219.  
  4220.  
  4221.  
  4222.  
  4223.     ════════════════════════════════════════════════════════════════════════
  4224.     (C) Fabiano Fabris 1990, 1991                                    Page 58
  4225.     ════════════════════════════════════════════════════════════════════════
  4226.  
  4227.     ════════════════════════════════════════════════════════════════════════
  4228.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4229.     ════════════════════════════════════════════════════════════════════════
  4230.  
  4231.  
  4232.            4) /W<to_who>
  4233.  
  4234.               You may optionally specify the name of the person to whom the
  4235.               message is  addressed.  If  this parameter  is  omitted,  the
  4236.               message will be addressed to 'All'.
  4237.  
  4238.               If the  /W parameter  is  used, the  name should  contain  no
  4239.               spaces; replace the spaces with underscores: /WFabiano_Fabris
  4240.  
  4241.  
  4242.            5) /R<from_who>
  4243.  
  4244.               By default, POST will use the name defined in the Sysop field
  4245.               in IMSETUP to indicate the name of the sender of the message.
  4246.               If you want  to use  another name,  specify it  after the  /R
  4247.               switch. The name should contain no spaces; replace any spaces
  4248.               with an underscore.
  4249.  
  4250.  
  4251.            6) /S<subject>
  4252.  
  4253.               You may also specify the subject  of the message with the  /S
  4254.               switch. If  this parameter  is omitted,  the message  subject
  4255.               will be 'News'.
  4256.  
  4257.               If you do use this  parameter, the text following the  switch
  4258.               should contain no spaces; replace them with underscores.  For
  4259.               example: /STest_message_#1
  4260.  
  4261.  
  4262.         j. RECOVER (R) - Unerase messages
  4263.  
  4264.            The RECOVER command  will allow  you to  "undelete" messages  in
  4265.            your message base. Naturally, it will only work if you have  not
  4266.            PACKed the base.
  4267.  
  4268.            By default,  RECOVER  will  "undelete"  messages  found  in  any
  4269.            message area, prompting  you at each  message. However, you  may
  4270.            specify that it look for messages  in a specific area, and  that
  4271.            it automatically recover all deleted messages it finds.
  4272.  
  4273.            The syntax of the command is:
  4274.  
  4275.               IMTHINGS RECOVER /A<areaname>
  4276.                                /B<board>
  4277.                                /U
  4278.  
  4279.  
  4280.            1) /A<areaname>
  4281.  
  4282.               If specified, the /A  switch indicates the  name of the  echo
  4283.               area to search for  deleted messages. If  given, then the  /B
  4284.               switch (see below) should NOT be given.
  4285.  
  4286.  
  4287.  
  4288.     ════════════════════════════════════════════════════════════════════════
  4289.     (C) Fabiano Fabris 1990, 1991                                    Page 59
  4290.     ════════════════════════════════════════════════════════════════════════
  4291.  
  4292.     ════════════════════════════════════════════════════════════════════════
  4293.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4294.     ════════════════════════════════════════════════════════════════════════
  4295.  
  4296.  
  4297.            2) /B<board>
  4298.  
  4299.               If specified, this switch indicates  the board to search  for
  4300.               deleted messages.  Giving the  board number  allows you  more
  4301.               flexibility, since  local message  areas are  not defined  as
  4302.               echo areas, and therefore have no name - the /A switch cannot
  4303.               be used. If you  use this switch, the  /A switch (see  above)
  4304.               should NOT be given.
  4305.  
  4306.  
  4307.            3) /U - Automatic Mode
  4308.  
  4309.               Automatic mode. If  this switch  is given,  RECOVER will  not
  4310.               prompt you at each message.  Instead, it will "undelete"  all
  4311.               messages it finds (if /A  or /B are specified, only  messages
  4312.               in the specified message area will be recovered).
  4313.  
  4314.  
  4315.         k. SEND (R) - Send a file
  4316.  
  4317.            The SEND command invokes the IMAIL Robot. This will allow you to
  4318.            send a  file and/or  message to  another system,  much like  any
  4319.            other Robot program.
  4320.  
  4321.            This command is available only in registered copies of IMAIL.
  4322.  
  4323.            The syntax of the SEND command is:
  4324.  
  4325.               IMTHINGS SEND /F<filename>
  4326.                             /A<address>
  4327.                             /W<to_who>
  4328.                             /T<text>
  4329.                             /C | /H
  4330.                             /D
  4331.                             /K
  4332.                             /E
  4333.                             /Y<days>
  4334.                             /N<1-16>
  4335.  
  4336.            If a file name is given with /F, and the required file is found,
  4337.            a file  attach  message  will  be generated  in  your  Net  Mail
  4338.            directory. However, it is also possible omit the file name,  and
  4339.            simply specify a text file (with  /T). In this case, a net  mail
  4340.            message will  be generated,  with no  attached file.  Note  that
  4341.            either a file or a message text (or both) must be specified;  if
  4342.            both are omitted, SEND will exit with an error.
  4343.  
  4344.            This command is available to registered users only.
  4345.  
  4346.  
  4347.            1) /F<filename>
  4348.  
  4349.               Indicates the  full pathname  of the  file to  be sent.  This
  4350.               parameter is not required  if you simply wish  to send a  net
  4351.               mail message.
  4352.  
  4353.     ════════════════════════════════════════════════════════════════════════
  4354.     (C) Fabiano Fabris 1990, 1991                                    Page 60
  4355.     ════════════════════════════════════════════════════════════════════════
  4356.  
  4357.     ════════════════════════════════════════════════════════════════════════
  4358.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4359.     ════════════════════════════════════════════════════════════════════════
  4360.  
  4361.  
  4362.               If the filename contains  wildcards, only the first  matching
  4363.               file will be sent.
  4364.  
  4365.  
  4366.            2) /A<address>
  4367.  
  4368.               Specifies the destination address of the file. This parameter
  4369.               is required.
  4370.  
  4371.               The address should  contain the zone,  otherwise the zone  of
  4372.               your primary address will be used by default.
  4373.  
  4374.  
  4375.            3) /W<to_who>
  4376.  
  4377.               You may optionally specify the name of the person to whom the
  4378.               file is being sent. If this parameter is omitted, the message
  4379.               will be addressed to 'Sysop'.
  4380.  
  4381.               If the  /W parameter  is  used, the  name should  contain  no
  4382.               spaces; replace the spaces with underscores: /WFabiano_Fabris
  4383.  
  4384.  
  4385.            4) /T<text>
  4386.  
  4387.               This switch allows you to specify the name of a text file  to
  4388.               be used as the "body" of the file attach message. If omitted,
  4389.               the message  will  have no  text.  It  may also  be  used  to
  4390.               generate a normal net mail message if the /F parameter is not
  4391.               given.
  4392.  
  4393.  
  4394.            5) /C - Crash
  4395.  
  4396.               Mark message with Crash status.
  4397.  
  4398.               This option is mutually exclusive with the Hold option below.
  4399.  
  4400.  
  4401.            6) /H - Hold
  4402.  
  4403.               Mark message with Hold status.
  4404.  
  4405.               This option  is  mutually  exclusive with  the  Crash  option
  4406.               above.
  4407.  
  4408.  
  4409.            7) /D - Direct
  4410.  
  4411.               Send message  Direct. This  means that  in no  case will  the
  4412.               message be routed via another system. It may be used together
  4413.               with the /C or the /H option.
  4414.  
  4415.               Use this  flag only  if your  mailer supports  the FLAGS  DIR
  4416.               kludge.
  4417.  
  4418.     ════════════════════════════════════════════════════════════════════════
  4419.     (C) Fabiano Fabris 1990, 1991                                    Page 61
  4420.     ════════════════════════════════════════════════════════════════════════
  4421.  
  4422.     ════════════════════════════════════════════════════════════════════════
  4423.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4424.     ════════════════════════════════════════════════════════════════════════
  4425.  
  4426.  
  4427.            8) /K - Kill/Sent
  4428.  
  4429.               Marks the message  as Kill/Sent. In  other words, once  sent,
  4430.               the message will be automatically deleted from your Net  Mail
  4431.               directory. Otherwise, it will remain, but be marked as Sent.
  4432.  
  4433.  
  4434.            9) /E - Delete/Sent
  4435.  
  4436.               Marks the message as Delete/Sent. This will cause the  mailer
  4437.               to delete the file once it has been sent.
  4438.  
  4439.               Use this  flag only  if your  mailer supports  the FLAGS  KFS
  4440.               kludge.
  4441.  
  4442.  
  4443.            10) /Y<days> - Newer than
  4444.  
  4445.               Indicates that the file must be  newer than <days> for it  to
  4446.               be sent.
  4447.  
  4448.               This is useful for  sending nodelist files,  as you can  then
  4449.               specify a wildcard  in the  filename, and  indicate that  the
  4450.               file be sent only if it is newer than, say, 6 days.
  4451.  
  4452.  
  4453.            11) /N<1-16> - Alternate AKA
  4454.  
  4455.               Tells IMAIL to use one of  your AKAs instead of your  primary
  4456.               address when  generating  the  outgoing  message,  where  the
  4457.               number indicates the AKA as listed in IMSETUP.
  4458.  
  4459.  
  4460.         l. SORT - Sort the Message Base
  4461.  
  4462.            The SORT function will  sort the message  base by message  date.
  4463.            What it  does is  to read  in the  MSGHDR.BBS file,  saving  the
  4464.            message number and time stamp. The list thus created is  sorted,
  4465.            and then the MSGHDR.BBS file  is rewritten, following the  order
  4466.            of the new message numbers.
  4467.  
  4468.            Note that the  SORT command  destroys the message  links, so  it
  4469.            automatically runs INDEX and LINK once it has terminated.
  4470.  
  4471.            SORT also updates  USERS.BBS (if found)  and LASTREAD.BBS;  this
  4472.            may account  for the  last message  number read  being  suddenly
  4473.            moved; previously  "older" messages  have  a newer  date  and/or
  4474.            time.
  4475.  
  4476.            The syntax of the SORT function is:
  4477.  
  4478.               IMTHINGS SORT [/Q]
  4479.  
  4480.  
  4481.  
  4482.  
  4483.     ════════════════════════════════════════════════════════════════════════
  4484.     (C) Fabiano Fabris 1990, 1991                                    Page 62
  4485.     ════════════════════════════════════════════════════════════════════════
  4486.  
  4487.     ════════════════════════════════════════════════════════════════════════
  4488.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4489.     ════════════════════════════════════════════════════════════════════════
  4490.  
  4491.  
  4492.            1) /Q - "Quick" Sort
  4493.  
  4494.               The /Q switch  forces a  "quick" sort. In  other words,  only
  4495.               those messages  numbered  higher than  the  highest  lastread
  4496.               pointer will be sorted.  The advantage of  this is that  your
  4497.               users  will  not  have  to  read  old  messages  again.   The
  4498.               disadvantage is that, due to the way certain message  editors
  4499.               assign new  message  numbers, it  is  possible that  a  small
  4500.               number of "old" messages will  be overwritten. Thus it  might
  4501.               be advisable to run IMTHINGS PACK prior to calling SORT  with
  4502.               this switch.
  4503.  
  4504.  
  4505.         m. STAT - Generate Statistics Report
  4506.  
  4507.            The STAT function allows  you to generate a  report of the  echo
  4508.            mail traffic on your system.
  4509.  
  4510.            During each run of IMAIL's TOSS and SCAN functions, IMAIL  keeps
  4511.            track of how  many messages were  imported and/or exported.  The
  4512.            STAT function  of  IMTHINGS  will generate  a  summary  of  this
  4513.            information to the  file specified  in IMSETUP  (Echo Stats  Log
  4514.            File).
  4515.  
  4516.            Note that  if any  of the  echo area  names are  longer than  20
  4517.            characters, they will be truncated in the report.
  4518.  
  4519.            The syntax of the STAT command is:
  4520.  
  4521.               IMTHINGS STAT /C
  4522.                             /E
  4523.                             /F<file>
  4524.                             /G<group_list>
  4525.                             /K
  4526.                             /B | /R | /N
  4527.  
  4528.  
  4529.            1) /C - Use only low ASCII
  4530.  
  4531.               If you need to export the  file generated by STAT to an  echo
  4532.               area, it  is suggested  that  this switch  be used.  It  will
  4533.               prevent STAT from using the high ASCII characters it normally
  4534.               uses when creating  its report;  only low  ASCII (codes  less
  4535.               than 128) will be used.
  4536.  
  4537.  
  4538.            2) /E - Show Empty Areas Also
  4539.  
  4540.               Normally, STAT does not show information for echo areas which
  4541.               have had  no mail  traffic;  if you  specify the  /E  switch,
  4542.               however, the  empty  areas  will be  logged  along  with  the
  4543.               others.
  4544.  
  4545.  
  4546.  
  4547.  
  4548.     ════════════════════════════════════════════════════════════════════════
  4549.     (C) Fabiano Fabris 1990, 1991                                    Page 63
  4550.     ════════════════════════════════════════════════════════════════════════
  4551.  
  4552.     ════════════════════════════════════════════════════════════════════════
  4553.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4554.     ════════════════════════════════════════════════════════════════════════
  4555.  
  4556.  
  4557.            3) /F - Echo Stat Log File
  4558.  
  4559.               This switch allows you  to specify the name  and path of  the
  4560.               file to which echo  statistics should be  logged. If none  is
  4561.               supplied, the default is ECHOSTAT.LOG, which will be  created
  4562.               either in the directory pointed  to by the IMAIL  environment
  4563.               variable, or if this is  not defined, in the current  working
  4564.               directory. For example:
  4565.  
  4566.                  IMTHINGS STAT /F\net\log\stat.log
  4567.  
  4568.  
  4569.            4) /G - Groups
  4570.  
  4571.               This switch allows you to specify a list of groups to show in
  4572.               the  generated   stat   file.  They   should   be   specified
  4573.               contiguously after the switch; for example:
  4574.  
  4575.                  IMTHINGS STAT /GABFZ
  4576.  
  4577.               will generate  statistics for  groups  A, B,  F and  Z  only.
  4578.               Information for any other groups  will not be reset,  whether
  4579.               or not the /K switch (see below) is specified. Also note that
  4580.               if not all groups are specified,  the date of the "last  run"
  4581.               is not set to the current date, but maintained.
  4582.  
  4583.  
  4584.            5) /K - Keep Statistics Information
  4585.  
  4586.               After every run of IMTHINGS STAT, the internal counters  will
  4587.               be zeroed, so each  run will generate statistics  accumulated
  4588.               since  the  previous  run.  This  unless  the  /K  switch  is
  4589.               specified, in which case, the  internal counters will not  be
  4590.               modified, and running totals can be generated.
  4591.  
  4592.  
  4593.            6) /B - Sort by Board number
  4594.  
  4595.               If this switch is  specified, the listing  will be sorted  by
  4596.               board number
  4597.  
  4598.  
  4599.            7) /R - Sort by Group
  4600.  
  4601.               If you specify the  /R switch, the output  will be sorted  by
  4602.               Group.
  4603.  
  4604.  
  4605.            8) /N - Sort by Area Name
  4606.  
  4607.               If you specify the /N switch,  the listing will be sorted  by
  4608.               area name. This is also the default; in other words, if  none
  4609.               of /B, /R or /N are given, the listing will be sorted by area
  4610.               name.
  4611.  
  4612.  
  4613.     ════════════════════════════════════════════════════════════════════════
  4614.     (C) Fabiano Fabris 1990, 1991                                    Page 64
  4615.     ════════════════════════════════════════════════════════════════════════
  4616.  
  4617.     ════════════════════════════════════════════════════════════════════════
  4618.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4619.     ════════════════════════════════════════════════════════════════════════
  4620.  
  4621.  
  4622.      11. AN OVERVIEW OF ECHOMAIL
  4623.  
  4624.         Information derived from FTS-0004.
  4625.  
  4626.  
  4627.         a. What is Echo Mail?
  4628.  
  4629.            Echo Mail  is  a technique  which  permits several  nodes  in  a
  4630.            network to share messages. All systems sharing a given echo  see
  4631.            any messages entered into the  echo by any of the  participating
  4632.            systems. This can be implemented in such a way as to be  totally
  4633.            transparent to the users of  a particular system. In fact,  they
  4634.            may not even be  aware of the network  being used to move  their
  4635.            messages about from  node to  node! This  has its  disadvantages
  4636.            also - most users  who are not educated  about Echo Mail do  not
  4637.            realize the  messages transmitted  cost MANY  sysops money,  not
  4638.            just the local sysop. This is an important consideration in Echo
  4639.            Mail and  should not  be  taken lightly.  In  an echo  with  100
  4640.            systems as participants the cost per message can get quite high.
  4641.  
  4642.  
  4643.         b. How it Works
  4644.  
  4645.            In general, the process is:
  4646.  
  4647.               1. A message in entered into  a designated area on a  FidoNet
  4648.               or compatible system.
  4649.  
  4650.               2.  This  message  is  "exported"  along  with  some  control
  4651.               information to each system "linked"  to the echo through  the
  4652.               originating system.
  4653.  
  4654.               3. Each of  the receiving systems  "import" the message  into
  4655.               the proper Echo Mail area.
  4656.  
  4657.               4. The receiving systems then "export" these messages,  along
  4658.               with additional control information, to each of their links.
  4659.  
  4660.               5. Return to step 3.
  4661.  
  4662.            The method is quite  simple - in  general. Of course,  following
  4663.            the steps literally would mean  messages would never stop  being
  4664.            exported and transmitted to other systems. This obviously is not
  4665.            desired as the  network would quickly  become overburdened.  The
  4666.            information contained in  the 'control  information' section  is
  4667.            used to prevent transmitting the same message more than once  to
  4668.            a single system.
  4669.  
  4670.  
  4671.         c. Echo Mail Message Control Information
  4672.  
  4673.            There are five pieces of control information associated with  an
  4674.            Echo Mail message.  Some are  optional, some  are not.  Normally
  4675.            this information is  never entered  by the  person creating  the
  4676.  
  4677.  
  4678.     ════════════════════════════════════════════════════════════════════════
  4679.     (C) Fabiano Fabris 1990, 1991                                    Page 65
  4680.     ════════════════════════════════════════════════════════════════════════
  4681.  
  4682.     ════════════════════════════════════════════════════════════════════════
  4683.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4684.     ════════════════════════════════════════════════════════════════════════
  4685.  
  4686.  
  4687.            message, but rather is added by the program which is responsible
  4688.            for the exporting of the original message. The following control
  4689.            fields determine how Echo Mail is handled:
  4690.  
  4691.  
  4692.            1) Area Line
  4693.  
  4694.               This is the first  line of an echo  mail message. Its  actual
  4695.               appearance is:
  4696.  
  4697.                  AREA:CONFERENCE
  4698.  
  4699.               where CONFERENCE is the name of the echo. This line is  added
  4700.               when a conference is being  "exported" to another system.  It
  4701.               is based upon information found in the configuration file for
  4702.               the designated message area (in the case of IMAIL, this  file
  4703.               is IMAIL.AR). This field is REQUIRED by the receiving  system
  4704.               to "import" a message into the correct Echo Mail area.
  4705.  
  4706.               Note that  IMAIL will  not handle  echo mail  messages  which
  4707.               "kludge" this field by putting a ^A character in front of it;
  4708.               these messages will be tossed into your net mail directory.
  4709.  
  4710.               Note also that you  may not have two  areas defined with  the
  4711.               same area  name;  this would  create  cross-linked  messages,
  4712.               which are a potential source of duplicates.
  4713.  
  4714.  
  4715.            2) Tear Line
  4716.  
  4717.               This line is near the end of a message and consists of  three
  4718.               dashes (---) followed by an optional program specifier.  This
  4719.               is used  to show  the first  program used  to add  Echo  Mail
  4720.               compatible control information to the message. The tear  line
  4721.               generated by IMAIL looks like:
  4722.  
  4723.                   --- <a small product-specific banner>
  4724.  
  4725.               This  field  is  optional  for  most  Echo  Mail   compatible
  4726.               processors. Some systems will place this line in the  message
  4727.               when it is first created, but  it is normally added when  the
  4728.               message is first "exported."
  4729.  
  4730.  
  4731.            3) Origin Line
  4732.  
  4733.               This line appears near  the bottom of a  message and gives  a
  4734.               small  amount  of  information  about  the  system  where  it
  4735.               originated. It looks like:
  4736.  
  4737.                   * Origin: The Home of IMAIL (2:230/41.22)
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.     ════════════════════════════════════════════════════════════════════════
  4744.     (C) Fabiano Fabris 1990, 1991                                    Page 66
  4745.     ════════════════════════════════════════════════════════════════════════
  4746.  
  4747.     ════════════════════════════════════════════════════════════════════════
  4748.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4749.     ════════════════════════════════════════════════════════════════════════
  4750.  
  4751.  
  4752.               The " * Origin: " part of the line is a constant field.  This
  4753.               is followed by a banner which should in some way identify the
  4754.               system which  originated the  message. The  complete  network
  4755.               address (2:230/41.22 in  this case) is  added by the  program
  4756.               inserting the line. This field is generated at the same  time
  4757.               as the tear line,  and therefore may  either be generated  at
  4758.               the time of creation or during the first "export" processing.
  4759.  
  4760.  
  4761.            4) SEEN-BY Lines
  4762.  
  4763.               There can  be many  SEEN-BY lines  at the  end of  Echo  Mail
  4764.               messages, and  they  are  the  real  "meat"  of  the  control
  4765.               information. They  are  used  to  determine  the  systems  to
  4766.               receive the exported messages. The format of the line is:
  4767.  
  4768.                  SEEN-BY: 132/101 113 136/601 1014/1
  4769.  
  4770.               The net/node numbers  correspond to the  net/node numbers  of
  4771.               the systems having already received (or "seen") the  message.
  4772.               In this way a message is never sent to a system twice. In  an
  4773.               Echo with many participants the  number of SEEN-BY lines  can
  4774.               be very large. This line is added if it is not already a part
  4775.               of the message, or added to if it already exists, each time a
  4776.               message is  exported to  other systems.  This is  a  REQUIRED
  4777.               field, and IMAIL will not function correctly if this field is
  4778.               not put in place by other Echo Mail compatible programs.
  4779.  
  4780.  
  4781.            5) PATH Lines
  4782.  
  4783.               These are the last lines in an Echo Mail message. They appear
  4784.               as follows:
  4785.  
  4786.                  ^APATH: 132/101 1014/1
  4787.  
  4788.               where the ^A stands for Control-A (ASCII character 1) and the
  4789.               net/nodes listed correspond to those systems having processed
  4790.               the message before it reached the current system. This is not
  4791.               the same as the SEEN-BY  lines, because those lines list  all
  4792.               systems the message  has been  sent to, while  the path  line
  4793.               contains all systems having actually processed the message.
  4794.  
  4795.  
  4796.         d. Methods of Sending Echo Mail
  4797.  
  4798.            To this point the  issue of how Echo  Mail is actually sent  has
  4799.            been glossed over entirely. The phrase has been, "the message is
  4800.            exported to another system." What exactly does this mean?
  4801.  
  4802.            Thom Henderson (from System Enhancement Associates) came up with
  4803.            the original ARCmail program. Having previously written the  ARC
  4804.            file archiving  and compression  program,  he knew  the  savings
  4805.            achievable by having all of the Net Mail messages placed in .ARC
  4806.            format for transmission. As a by-product, the messages no longer
  4807.  
  4808.     ════════════════════════════════════════════════════════════════════════
  4809.     (C) Fabiano Fabris 1990, 1991                                    Page 67
  4810.     ════════════════════════════════════════════════════════════════════════
  4811.  
  4812.     ════════════════════════════════════════════════════════════════════════
  4813.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4814.     ════════════════════════════════════════════════════════════════════════
  4815.  
  4816.  
  4817.            appeared in  the net  mail area,  but were  included in  a  file
  4818.            attached to  a message.  In this  way the  tremendous number  of
  4819.            messages generated,  and  the  phone  bill  problems  were  both
  4820.            solved.
  4821.  
  4822.            IMAIL builds the ARCmail files  during export, and unpacks  them
  4823.            during import.  This  way  messages  are  exported  directly  to
  4824.            ARCmail style file attaches, and imported directly from  ARCmail
  4825.            style file attaches.
  4826.  
  4827.  
  4828.         e. Topology
  4829.  
  4830.            The way in which systems link together for a particular Echo  is
  4831.            called the  "echo  topology."  It  is  important  to  know  this
  4832.            structure for two reasons:
  4833.            1) it is important to have a topology which is efficient in  the
  4834.            transfer of the Echo Mail messages;
  4835.            2) it  is important  to have  a topology  which will  not  cause
  4836.            systems to see the same messages more than once.
  4837.  
  4838.            Efficiency can  be measured  in  a number  of ways;  least  time
  4839.            involved for all systems  to receive a  message, least cost  for
  4840.            all systems  to  receive  a  message,  and  fewest  phone  calls
  4841.            required for  all systems  to receive  a message  are all  valid
  4842.            indicators of efficiency. Users of Echo Mail compatible  systems
  4843.            have determined (through  trial and error)  the best measure  of
  4844.            efficiency is a  combination of  all three  of the  measurements
  4845.            given above. Balancing  the equation  is not  trivial, but  some
  4846.            guidelines can be given:
  4847.  
  4848.               1. Never have  two systems  attempting to send  Echo Mail  to
  4849.               each other at  the same  time. This  results in  "collisions"
  4850.               that will  cause both  systems to  fail. To  avoid this,  one
  4851.               system should  be responsible  for  polling while  the  other
  4852.               system is holding mail. This arrangement can alternate  based
  4853.               upon various  criteria,  but  both systems  should  never  be
  4854.               attempting to call each other at the same time.
  4855.  
  4856.               2. Have nodes  form "stars"  for distribution  of Echo  Mail.
  4857.               This arrangement has several  nodes all receiving their  Echo
  4858.               Mail from  the same  system. In  general the  systems on  the
  4859.               "outside" of the star  poll the system  on the "inside".  The
  4860.               system on the "inside" in turn polls other systems to receive
  4861.               the Echo  Mail  that is  being  passed on  to  the  "outside"
  4862.               systems.
  4863.  
  4864.               3. Utilize  fully connected  polygons  with a  few  vertices.
  4865.               Nodes can be connected in a triangle  (A sends to B and C,  B
  4866.               sends to A and C,  C sends to A and  B) or a fully  connected
  4867.               square (all corners of  the square send to  all of the  other
  4868.               corners).  This  method  is  useful  for  getting  Echo  Mail
  4869.               messages to each node as quickly as possible.
  4870.  
  4871.  
  4872.  
  4873.     ════════════════════════════════════════════════════════════════════════
  4874.     (C) Fabiano Fabris 1990, 1991                                    Page 68
  4875.     ════════════════════════════════════════════════════════════════════════
  4876.  
  4877.     ════════════════════════════════════════════════════════════════════════
  4878.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4879.     ════════════════════════════════════════════════════════════════════════
  4880.  
  4881.  
  4882.            All of these efficiency guidelines have to be tempered with  the
  4883.            guidelines dealing with  keeping duplicate  messages from  being
  4884.            exported. Duplicates will  occur in  any topology  that forms  a
  4885.            closed polygon that is not fully connected. Take for example the
  4886.            following configuration:
  4887.  
  4888.                                      A ----- B
  4889.                                      |       |
  4890.                                      |       |
  4891.                                      C ----- D
  4892.  
  4893.            This square is a closed polygon that is not fully connected.  It
  4894.            is capable of generating duplicates as follows:
  4895.  
  4896.               1. A message is entered on node A.
  4897.  
  4898.               2. Node A exports  the message to node  B and node C  placing
  4899.               the SEEN-BY for A, B, and C in the message as it does so.
  4900.  
  4901.               3. Node B sees that node D  is not listed in the SEEN-BY  and
  4902.               exports the message to node D.
  4903.  
  4904.               4. Node C sees that node D  is not listed in the SEEN-BY  and
  4905.               exports the message to node D.
  4906.  
  4907.            At this point  node D has  received the same  message twice -  a
  4908.            duplicate was generated. Normally a  "dupe-ring" will not be  as
  4909.            simple as a square. Generally it  will be caused by a system  on
  4910.            one end of a long chain  accidentally connecting to a system  on
  4911.            the other end  of the  chain. This causes  the two  ends of  the
  4912.            chain to become connected, forming a polygon.
  4913.  
  4914.  
  4915.         f. Why a PATH line?
  4916.  
  4917.            The PATH line stores the net/node numbers of each system  having
  4918.            actually processed  a message.  This  information is  useful  in
  4919.            correcting the biggest problem  encountered by nodes running  an
  4920.            Echo Mail compatible system -  the problem of finding the  cause
  4921.            of duplicate messages. How  does the PATH  line help solve  this
  4922.            problem? Take the following path line as an example:
  4923.  
  4924.               ^aPATH: 107/6 107/312 107/528 107/312 132/101
  4925.  
  4926.            This shows the message having been processed by node 107/312  on
  4927.            more than one  occasion. Based upon  the earlier description  of
  4928.            the 'information  control' fields  in Echo  Mail messages,  this
  4929.            clearly is an error in processing (see Section b. entitled  "How
  4930.            it Works"). This further  shows node 107/528  as the node  which
  4931.            apparently processed the message  incorrectly. In this case  the
  4932.            path line can be used to quickly locate the source of  duplicate
  4933.            messages.
  4934.  
  4935.  
  4936.  
  4937.  
  4938.     ════════════════════════════════════════════════════════════════════════
  4939.     (C) Fabiano Fabris 1990, 1991                                    Page 69
  4940.     ════════════════════════════════════════════════════════════════════════
  4941.  
  4942.     ════════════════════════════════════════════════════════════════════════
  4943.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  4944.     ════════════════════════════════════════════════════════════════════════
  4945.  
  4946.  
  4947.            In an Echo with many  participants it becomes almost  impossible
  4948.            to determine the exact topology used. In these cases the use  of
  4949.            the path  line can  help a  coordinator of  the Echo  track  any
  4950.            possible  breakdowns  in   the  overall   topology,  while   not
  4951.            substantially increasing the amount of information  transmitted.
  4952.            Having this small amount of information added to the end of each
  4953.            message pays for itself very quickly when it can be used to help
  4954.            detect a  topology  problem  causing duplicate  messages  to  be
  4955.            transmitted to each system.
  4956.  
  4957.  
  4958.         g. Gating of Echo Mail
  4959.  
  4960.            Until recently, the only network  which made use of the  methods
  4961.            described  above  was  FidoNet.   However,  new  networks   have
  4962.            appeared, and the  problem of  sharing Echo  Mail between  these
  4963.            networks arose.  (To  avoid  ambiguity, the  term  "domain"  was
  4964.            introduced to distinguish between  networks such as FidoNet  and
  4965.            SIGnet.)
  4966.  
  4967.            Sharing (or gating)  of Echo Mail  presents technical  problems.
  4968.            Put simply, the network addresses which are valid in one  domain
  4969.            may not appear in the messages of another domain.
  4970.  
  4971.            The reason for  this is that,  if we consider  only the net  and
  4972.            node fields of a network  address (many mail processors are  not
  4973.            able to  handle the  zone and  point fields),  there is  a  high
  4974.            possibility that a given address exists in another domain.
  4975.  
  4976.            With net  mail, this  problem  may be  solved by  enforcing  the
  4977.            requirement that  inter-domain  mail  be sent  directly  to  its
  4978.            destination, or at least, to a gateway system.
  4979.  
  4980.            With Echo  Mail,  the  problem  is  more  complex,  due  to  the
  4981.            information  contained  in  the  SEEN-BY  and  PATH  lines   (as
  4982.            described above). These lines contain network addresses, and are
  4983.            needed to prevent duplicate rings.
  4984.  
  4985.            However, a strategy has evolved which will allow Echo Mail to be
  4986.            gated.
  4987.  
  4988.            Above all, only ONE system should  be allowed to gate Echo  Mail
  4989.            between domains. This may be  done on a world-wide or  Zone-wide
  4990.            basis. This system  will be responsible  for receiving the  mail
  4991.            from one domain, and feeding it into the other.
  4992.  
  4993.            This is not enough. Due to the possibility of duplicate  network
  4994.            addresses, all SEEN-BYs and PATH lines should be removed  during
  4995.            the gating process. This explains why only one system should  be
  4996.            allowed to gate Echo Mail.
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.     ════════════════════════════════════════════════════════════════════════
  5004.     (C) Fabiano Fabris 1990, 1991                                    Page 70
  5005.     ════════════════════════════════════════════════════════════════════════
  5006.  
  5007.     ════════════════════════════════════════════════════════════════════════
  5008.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5009.     ════════════════════════════════════════════════════════════════════════
  5010.  
  5011.  
  5012.      12. KLUDGE LINES USED BY IMAIL
  5013.  
  5014.         For the more  technically minded, there  follows an explanation  of
  5015.         the various kludge lines that IMAIL may place in messages.
  5016.  
  5017.         A kludge line  is generally defined  as any line  preceded by a  ^A
  5018.         (Control-A) character, and may be  found either before the  message
  5019.         text itself, or after it.
  5020.  
  5021.  
  5022.         a. EID
  5023.  
  5024.            The EID is used only in  Echo Mail messages. IMAIL does NOT  add
  5025.            this kludge  to  echo messages.  It  was 'invented'  mostly  for
  5026.            reasons of dupe checking, but  IMAIL will use other methods  for
  5027.            this purpose.
  5028.  
  5029.            The format of the kludge varies; according to the  specification
  5030.            proposed by Jim Nutt, it may be:
  5031.  
  5032.               ^AEID zddd nnnccccc
  5033.  
  5034.            where z is the zone modulo 16,  ddd is the net modulo 4096,  nnn
  5035.            is the net modulo  4096, and ccccc is  a message serial  number.
  5036.            The serial number is generated using  the low order word of  the
  5037.            Unix time  stamp shifted  left  4 bits,  with a  nybble  counter
  5038.            appended.
  5039.  
  5040.  
  5041.         b. FLAGS
  5042.  
  5043.            This kludge is present in net mail messages only, and is used by
  5044.            many mailers to give more information on how the message  should
  5045.            be treated. It is followed by one of more modifiers; some of the
  5046.            more common ones are listed below.
  5047.  
  5048.  
  5049.            1) DIR
  5050.  
  5051.               Indicates that the net mail message should be sent direct  to
  5052.               its destination; it will NEVER be routed.
  5053.  
  5054.               IMAIL allows you  to specify  whether mail  should be  marked
  5055.               DIRECT or  not.  See  the description  of  the  Node  Manager
  5056.               (Chapter 5. Section e.)
  5057.  
  5058.  
  5059.            2) IMM
  5060.  
  5061.               Indicates that a  message should be  sent immediately.  IMAIL
  5062.               will never use this, and will always ignore it.
  5063.  
  5064.  
  5065.  
  5066.  
  5067.  
  5068.     ════════════════════════════════════════════════════════════════════════
  5069.     (C) Fabiano Fabris 1990, 1991                                    Page 71
  5070.     ════════════════════════════════════════════════════════════════════════
  5071.  
  5072.     ════════════════════════════════════════════════════════════════════════
  5073.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5074.     ════════════════════════════════════════════════════════════════════════
  5075.  
  5076.  
  5077.            3) TFS
  5078.  
  5079.               Truncate File when Sent.  This is found  only in file  attach
  5080.               messages, and  indicates that  the file  should be  truncated
  5081.               when sent. ARCmail file attached generates by IMAIL will have
  5082.               this flag set.
  5083.  
  5084.  
  5085.            4) KFS
  5086.  
  5087.               Kill File  when  Sent. This  is  found only  in  file  attach
  5088.               messages, and means that the mailer will delete the file once
  5089.               sent.
  5090.  
  5091.               Please note that  ARCmail file attaches  should NOT use  this
  5092.               flag. If the  ARCmail file  is deleted, the  next time  IMAIL
  5093.               generates an outbound compressed  file for a system,  chances
  5094.               are that it will have the same name as the last one sent  (if
  5095.               the file is generated  on the same day,  at least). If it  is
  5096.               then sent out  to the  system, and  that system  has not  yet
  5097.               processed the mail it had  previously received, there is  the
  5098.               possibility that the  file will be  refused, overwritten,  or
  5099.               discarded.
  5100.  
  5101.  
  5102.            5) CFM
  5103.  
  5104.               Confirmation Receipt Request. This flag is set if the sending
  5105.               system wishes to have an acknowledgement that the message was
  5106.               read. As such, IMAIL does not  intercept this flag; it is  up
  5107.               to the message editor to handle it.
  5108.  
  5109.  
  5110.            6) RRQ
  5111.  
  5112.               Return Receipt  Request.  This flag  is  set if  the  sending
  5113.               system wishes to have an acknowledgement that the message was
  5114.               received by your system.
  5115.  
  5116.               Currently, IMAIL  does not  recognize  this flag,  since  the
  5117.               message header itself defines  a similar bit.  If the bit  is
  5118.               set,  a  registered  version  of  IMAIL  will   automatically
  5119.               generate a reply to the sending system.
  5120.  
  5121.  
  5122.         c. FMPT
  5123.  
  5124.            The FMPT kludge is used in net mail messages only. It is similar
  5125.            to the TOPT kludge, except that it is used to indicate that  the
  5126.            message originate from a point system.
  5127.  
  5128.            The format of this kludge is:
  5129.  
  5130.               ^AFMPT <orig point>
  5131.  
  5132.  
  5133.     ════════════════════════════════════════════════════════════════════════
  5134.     (C) Fabiano Fabris 1990, 1991                                    Page 72
  5135.     ════════════════════════════════════════════════════════════════════════
  5136.  
  5137.     ════════════════════════════════════════════════════════════════════════
  5138.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5139.     ════════════════════════════════════════════════════════════════════════
  5140.  
  5141.  
  5142.            where <orig point> is the point component of the address of  the
  5143.            system originating the message.
  5144.  
  5145.  
  5146.         d. INTL
  5147.  
  5148.            The INTL kludge is used in net mail messages only. It  indicates
  5149.            that the message is destined to  a zone which is different  from
  5150.            the one in which it originated.
  5151.  
  5152.            The format of the INTL kludge is:
  5153.  
  5154.               ^AINTL <dest zone:net/node> <orig zone:net/node>
  5155.  
  5156.            IMAIL will use this kludge  to try to determine zone  addresses,
  5157.            as well as  adding it to  net mail messages  it generates.  Note
  5158.            that in multi-domain environments  (ie, systems which belong  to
  5159.            more than one domain, and thus  more than one zone), IMAIL  will
  5160.            put an INTL kludge in ALL  net mail messages it generates,  even
  5161.            if the destination and origin zones are the same.
  5162.  
  5163.  
  5164.         e. MSGID
  5165.  
  5166.            A MSGID kludge is used in all messages, be they net mail of echo
  5167.            mail messages. They  are automatically  added by  IMAIL when  it
  5168.            generates messages (Automatic Reply, AreaLink's messages,  etc),
  5169.            and used in duplicate checking.
  5170.  
  5171.            The format of  the MSGID follows  the specification proposed  by
  5172.            Jim Nutt, which is:
  5173.  
  5174.               ^AMSGID: zone:net/node[.point]@domain xxxxxxxx
  5175.  
  5176.            where  zone,  net,  node  and  point  are  the  address  of  the
  5177.            origination system, and domain is the domain of the  originating
  5178.            system (eg. FidoNet, SIGnet, etc).  xxxxxxxx is a serial  number
  5179.            which is derived from the  originating system's address, a  Unix
  5180.            time stamp, and an internal counter.
  5181.  
  5182.            IMAIL will automatically supply the  domain by deriving it  from
  5183.            the zone number. If the zone number is not recognized, no domain
  5184.            field will be added.
  5185.  
  5186.  
  5187.         f. PID
  5188.  
  5189.            The PID (Product  ID) is appended  by IMAIL to  all messages  it
  5190.            generates.  Following  the   specifications  given  by   Joaquim
  5191.            Homrighausen, the format of the kludge is:
  5192.  
  5193.               ^APID: <product> <version> [<serial number>]
  5194.  
  5195.            For example, IMAIL 1.2 would generate the kludge as follows:
  5196.  
  5197.  
  5198.     ════════════════════════════════════════════════════════════════════════
  5199.     (C) Fabiano Fabris 1990, 1991                                    Page 73
  5200.     ════════════════════════════════════════════════════════════════════════
  5201.  
  5202.     ════════════════════════════════════════════════════════════════════════
  5203.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5204.     ════════════════════════════════════════════════════════════════════════
  5205.  
  5206.  
  5207.               ^APID: IMAIL 1.20
  5208.  
  5209.  
  5210.         g. REPLY
  5211.  
  5212.            The REPLY kludge is simply a copy of the MSGID of the message to
  5213.            which you are replying. IMAIL does not generate this, except  in
  5214.            the case of  an Automatic  Reply, but it  will use  it in  reply
  5215.            linking.
  5216.  
  5217.            The format is as for MSGIDs:
  5218.  
  5219.               ^AREPLY: zone:net/node[.point]@domain xxxxxxxx
  5220.  
  5221.  
  5222.         h. RESCANNED
  5223.  
  5224.            IMAIL inserts this kludge in  messages which have been  exported
  5225.            in response  to  a %RESCAN  request.  This way,  when  they  are
  5226.            processed by TOSS, they  will not be  exported to other  system,
  5227.            thus potentially creating dupe rings.
  5228.  
  5229.  
  5230.         i. TOPT
  5231.  
  5232.            To TOPT kludge is used in net mail messages only. It is used  to
  5233.            indicate that the message is directed to a point system,  rather
  5234.            than a "normal" node.
  5235.  
  5236.            The format of this kludge is:
  5237.  
  5238.               ^ATOPT <dest point>
  5239.  
  5240.            where <dest point> is  the point component  of the address.  For
  5241.            example, a message addressed to 2:310/11.22 will have:
  5242.  
  5243.               ^ATOPT 22
  5244.  
  5245.            while the message header will contain the address 310/11.
  5246.  
  5247.            Please note that IMAIL  supports the "extended" message  header,
  5248.            which contains  not only  the  net and  node addresses  (as  per
  5249.            standard), but also the zone and point field. However, since not
  5250.            all software  support  this header  format,  the TOPT  and  FMPT
  5251.            (below) kludges  are added  whenever  necessary, and  used  when
  5252.            examining inbound messages.
  5253.  
  5254.  
  5255.  
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.     ════════════════════════════════════════════════════════════════════════
  5264.     (C) Fabiano Fabris 1990, 1991                                    Page 74
  5265.     ════════════════════════════════════════════════════════════════════════
  5266.  
  5267.     ════════════════════════════════════════════════════════════════════════
  5268.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5269.     ════════════════════════════════════════════════════════════════════════
  5270.  
  5271.  
  5272.      13. BATCH FILE EXAMPLE
  5273.  
  5274.         The example given below is  designed for systems running  QuickBBS,
  5275.         with FrontDoor as a mailer. It  should be easy to modify for  other
  5276.         setups, but I can only write from my own experience.
  5277.  
  5278.         ECHO Off
  5279.         :START
  5280.           CD C:\QBBS
  5281.           FD
  5282.           IF ERRORLEVEL 99 GOTO CLEAN
  5283.           IF ERRORLEVEL 50 GOTO UNPACKMAIL
  5284.           IF ERRORLEVEL 40 GOTO LOCAL
  5285.           IF ERRORLEVEL 33 GOTO LOAD_2400
  5286.           IF ERRORLEVEL 32 GOTO LOAD_1200
  5287.           IF ERRORLEVEL 31 GOTO LOAD_300
  5288.           IF ERRORLEVEL 10 GOTO OUT
  5289.           IF ERRORLEVEL 6  GOTO ERROR6
  5290.           IF ERRORLEVEL 5  GOTO ERROR5
  5291.           IF ERRORLEVEL 4  GOTO ERROR4
  5292.           IF ERRORLEVEL 3  GOTO ERROR3
  5293.           IF ERRORLEVEL 2  GOTO ERROR2
  5294.           IF ERRORLEVEL 1  GOTO ERROR1
  5295.           GOTO START
  5296.         :LOAD_300
  5297.           QUICKBBS -B300 -E0
  5298.           GOTO START
  5299.         :LOAD_1200
  5300.           QUICKBBS -B1200 -E0
  5301.           GOTO START
  5302.         :LOAD_2400
  5303.           QUICKBBS -B2400 -E0
  5304.           GOTO START
  5305.         :LOCAL
  5306.           QUICKBBS -L -E0
  5307.           GOTO START
  5308.  
  5309.         :CLEAN
  5310.         rem Message Areas Maintenance
  5311.           IMTHINGS KILL /D10 /N50 /P
  5312.           GOTO START
  5313.  
  5314.         :UNPACKMAIL
  5315.           IMAIL TOSS
  5316.           IMPACK 1:all 2:all 3:all via 2:2/1
  5317.           GOTO START
  5318.  
  5319.         :ERROR1
  5320.           CLS
  5321.           ECHO *** Internal Error ***   Programming Error
  5322.           GOTO OUT
  5323.         :ERROR2
  5324.           CLS
  5325.           ECHO *** External Error ***    Missing File
  5326.           GOTO OUT
  5327.  
  5328.     ════════════════════════════════════════════════════════════════════════
  5329.     (C) Fabiano Fabris 1990, 1991                                    Page 75
  5330.     ════════════════════════════════════════════════════════════════════════
  5331.  
  5332.     ════════════════════════════════════════════════════════════════════════
  5333.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5334.     ════════════════════════════════════════════════════════════════════════
  5335.  
  5336.  
  5337.         :ERROR3
  5338.           CLS
  5339.           ECHO *** Insufficient Disk Space ***
  5340.           GOTO OUT
  5341.         :ERROR4
  5342.           CLS
  5343.           ECHO *** Modem not Responding ***
  5344.           GOTO OUT
  5345.         :ERROR5
  5346.           CLS
  5347.           ECHO *** Unable to Init Modem ***
  5348.           GOTO OUT
  5349.         :ERROR6
  5350.           CLS
  5351.           ECHO *** FOSSIL Error ***
  5352.         :OUT
  5353.            ECHO System .... Down!
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.     ════════════════════════════════════════════════════════════════════════
  5394.     (C) Fabiano Fabris 1990, 1991                                    Page 76
  5395.     ════════════════════════════════════════════════════════════════════════
  5396.  
  5397.     ════════════════════════════════════════════════════════════════════════
  5398.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5399.     ════════════════════════════════════════════════════════════════════════
  5400.  
  5401.  
  5402.      14. MISCELLANEOUS INFORMATION
  5403.  
  5404.  
  5405.         a. A Note about Capability
  5406.  
  5407.            The term Capability, when refered to a mail processor, indicates
  5408.            that program's ability to generate zone and point information in
  5409.            outgoing mail, as well as the ability to recognize and use  such
  5410.            information in inbound mail
  5411.  
  5412.            Currently, IMAIL distinguishes between two forms of  capability:
  5413.            "Stone Age" and  "Type 2+".  "Stone Age" means  that the  packet
  5414.            contains no zone  and/or point  information, and  thus IMAIL  is
  5415.            forced to guess  at their  value; "Type 2+"  indicates that  the
  5416.            packet contains  zone and  point  information, and  IMAIL  knows
  5417.            where to look for them.
  5418.  
  5419.            "Type 2+"  mail packets  are distinguished  from the  others  by
  5420.            means of a Capability Word and a Capability Word Validation Copy
  5421.            (as outlined  in  the  document FSC-0039).  However,  there  are
  5422.            several mail  processors  which  produce valid  zone  and  point
  5423.            information, but do not mark the packets as "Type 2+". In  order
  5424.            for IMAIL to correctly  extract the zone  and point fields  from
  5425.            these packets, they must be marked as
  5426.              Capability:    Type 2+
  5427.              Cap Handling:  Forced
  5428.            in the Node Manager (see Chapter 5. Section e.). In other words,
  5429.            you should  enquire as  to  which mail  processor echo  node  is
  5430.            using, and set these two fields accordingly.
  5431.  
  5432.            Examples of mail  processors which produce  Type 2+  information
  5433.            are:
  5434.  
  5435.               Product                      Product Code
  5436.               ---------------              ---------------
  5437.               D'Bridge                     1A
  5438.               GEcho                        61
  5439.               Qmail                        29
  5440.               ScanToss                     82
  5441.               TosScan                      3F
  5442.               ZmailQ                       35
  5443.  
  5444.            Some of these do not (yet) make use of the Capability Word,  but
  5445.            it is possible to "tell" IMAIL that a mail processor has Type 2+
  5446.            Capability by  indicating  its  product  code  in  IMSETUP  (see
  5447.            Chapter 5. section a.).
  5448.  
  5449.            For other  mail  processors,  unless  you  are  certain  of  the
  5450.            contrary, the best is to set the two capability fields to "Stone
  5451.            Age"/Auto.
  5452.  
  5453.  
  5454.  
  5455.  
  5456.  
  5457.  
  5458.     ════════════════════════════════════════════════════════════════════════
  5459.     (C) Fabiano Fabris 1990, 1991                                    Page 77
  5460.     ════════════════════════════════════════════════════════════════════════
  5461.  
  5462.     ════════════════════════════════════════════════════════════════════════
  5463.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5464.     ════════════════════════════════════════════════════════════════════════
  5465.  
  5466.  
  5467.         b. Files Maintained by IMAIL
  5468.  
  5469.            IMAIL and  IMSETUP create  and  maintain several  external  data
  5470.            files. Generally it is  NOT a good idea  to delete these  unless
  5471.            you wish to rebuild your configuration from the beginning.
  5472.  
  5473.            Of these  files,  all  those  containing  IMAIL's  configuration
  5474.            information (ie, all those whose name begins with IMAIL)  should
  5475.            reside in the directory from which IMAIL is run, or, if you have
  5476.            set the IMAIL environment variable,  in the directory it  points
  5477.            to.
  5478.  
  5479.               IMAIL.CF       Basic   IMAIL    configuration    information,
  5480.                              including network addresses, Pack Routing  and
  5481.                              so on.
  5482.  
  5483.               IMAIL.AR       Contains the definitions of the echo areas. If
  5484.                              this  file   is   deleted,   ALL   echo   area
  5485.                              information will be lost. This file is updated
  5486.                              by AreaLink,  if  necessary,  and  is  usually
  5487.                              maintained via IMSETUP.
  5488.  
  5489.               IMAIL.AX       Index file of the echo area information.  This
  5490.                              file is maintained and updated both by IMSETUP
  5491.                              and IMAIL. It  may be deleted  (in which  case
  5492.                              IMSETUP will recreate it),  but all echo  mail
  5493.                              statistics information will be lost.
  5494.  
  5495.               IMAIL.ND       This file contains the information defined  in
  5496.                              the Node Manager.
  5497.  
  5498.               IMAIL.DP       Data  base  of   information  used  to   catch
  5499.                              duplicate messages. This file may be  deleted,
  5500.                              but then you risk missing incoming dupes.
  5501.  
  5502.               ????????.$I$   A packet  file (????????.PKT)  that was  being
  5503.                              processed by TOSS. You should only find  these
  5504.                              files if  there was  a system  crash during  a
  5505.                              TOSS. In order to process it, simply run IMAIL
  5506.                              TOSS again.
  5507.  
  5508.  
  5509.         c. Exit Codes
  5510.  
  5511.            Should an error occur while IMAIL or IMTHINGS are running,  both
  5512.            programs will exit with an error, and set the MS-DOS  ERRORLEVEL
  5513.            environment variable. This may  be tested in  a batch file,  and
  5514.            acted upon. Listed below are  the ERRORLEVELs returned by  IMAIL
  5515.            and IMTHINGS.
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.     ════════════════════════════════════════════════════════════════════════
  5524.     (C) Fabiano Fabris 1990, 1991                                    Page 78
  5525.     ════════════════════════════════════════════════════════════════════════
  5526.  
  5527.     ════════════════════════════════════════════════════════════════════════
  5528.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5529.     ════════════════════════════════════════════════════════════════════════
  5530.  
  5531.  
  5532.              ERRORLEVEL          Meaning
  5533.              ──────────          ───────
  5534.              0                   No error
  5535.              1                   IMAIL TOSS processed net mail
  5536.              2                   IMAIL TOSS imported echo mail
  5537.              242                 File Locking error
  5538.              243                 Command line parameter error
  5539.              244                 IMAIL.CF not found
  5540.              245                 IMAIL.AR not found
  5541.              246                 IMAIL.ND not found
  5542.              247                 Error opening file
  5543.              248                 Error reading file
  5544.              249                 Error writing file
  5545.              250                 Error in IMAIL.CF
  5546.              251                 Bad version of IMAIL.CF
  5547.              252                 File not found
  5548.              253                 Memory allocation error
  5549.              254                 Insufficient disk space
  5550.              255                 Unknown error
  5551.  
  5552.  
  5553.  
  5554.  
  5555.  
  5556.  
  5557.  
  5558.  
  5559.  
  5560.  
  5561.  
  5562.  
  5563.  
  5564.  
  5565.  
  5566.  
  5567.  
  5568.  
  5569.  
  5570.  
  5571.  
  5572.  
  5573.  
  5574.  
  5575.  
  5576.  
  5577.  
  5578.  
  5579.  
  5580.  
  5581.  
  5582.  
  5583.  
  5584.  
  5585.  
  5586.  
  5587.  
  5588.     ════════════════════════════════════════════════════════════════════════
  5589.     (C) Fabiano Fabris 1990, 1991                                    Page 79
  5590.     ════════════════════════════════════════════════════════════════════════
  5591.  
  5592.     ════════════════════════════════════════════════════════════════════════
  5593.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5594.     ════════════════════════════════════════════════════════════════════════
  5595.  
  5596.  
  5597.      15. IMAIL DISTRIBUTION SITES
  5598.  
  5599.  
  5600.         a. Registration Sites
  5601.  
  5602.  
  5603.            1) Headquarters
  5604.  
  5605.               Intuition
  5606.  
  5607.                  System:                        FidoNet  2:230/41.22
  5608.                  +39-427-938827                 intlnet  57:57/0
  5609.  
  5610.                  Snail Mail:                    Fabiano Fabris
  5611.                                                 Via Zardini 19
  5612.                                                 33090 Sequals (PN)
  5613.                                                 Italy
  5614.  
  5615.  
  5616.            2) Australia
  5617.  
  5618.               IMAIL Support & Distribution Australia
  5619.  
  5620.                  System:                        FidoNet  3:632/350
  5621.                  +61-3-739-0028                 intlnet  58:4100/31
  5622.  
  5623.                  Snail Mail:                    Bob Snowdon
  5624.                                                 17 Witham Drive
  5625.                                                 Coldstream, Victoria
  5626.                                                 Australia 3770
  5627.  
  5628.  
  5629.            3) Austria
  5630.  
  5631.               Andreas Levenitschnig
  5632.  
  5633.                  System:                        FidoNet  2:2/1
  5634.                  +43-1-2430615
  5635.  
  5636.                  Snail Mail:                    Andreas Levenitschnig
  5637.                                                 Czerningasse 4/23
  5638.                                                 1020 Vienna
  5639.                                                 Austria
  5640.  
  5641.  
  5642.            4) Europe
  5643.  
  5644.               IMAIL Support & Distribution Europe
  5645.  
  5646.                  System:                        FidoNet  2:285/305
  5647.                  +31-10-4151910                 intlnet  57:3101/100
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.     ════════════════════════════════════════════════════════════════════════
  5654.     (C) Fabiano Fabris 1990, 1991                                    Page 80
  5655.     ════════════════════════════════════════════════════════════════════════
  5656.  
  5657.     ════════════════════════════════════════════════════════════════════════
  5658.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5659.     ════════════════════════════════════════════════════════════════════════
  5660.  
  5661.  
  5662.            5) Germany
  5663.  
  5664.                  Andreas Klein                  FidoNet  2:241/8002
  5665.                                                 intlnet  57:4980/103
  5666.  
  5667.  
  5668.            6) United Kingdom
  5669.  
  5670.               Cliff Jones
  5671.  
  5672.                  System:                        FidoNet  2:254/44
  5673.                                                 intlnet  57:4401/2
  5674.  
  5675.  
  5676.            7) North America
  5677.  
  5678.  
  5679.               - IMAIL Support & Distribution N.A. #1
  5680.  
  5681.                  System:                        SIGnet   24:24/7777
  5682.                  +1-604-873-6625                FidoNet  1:153/1025
  5683.  
  5684.                  Snail mail:                    Jamie Penner
  5685.                                                 293 East 11th Avenue
  5686.                                                 Vancouver, BC
  5687.                                                 Canada  V5T 2C4
  5688.  
  5689.  
  5690.               - IMAIL Support & Distribution N.A. #2
  5691.  
  5692.                  System:                        FidoNet  1:124/5102
  5693.                  +1-214-418-1129
  5694.  
  5695.                  Snail mail:                    Dale Richter
  5696.                                                 12226 Veronica Rd.
  5697.                                                 Dallas, TX 75234
  5698.                                                 U.S.A.
  5699.  
  5700.  
  5701.         b. Support Sites
  5702.  
  5703.  
  5704.            1) France
  5705.  
  5706.                  Pascal Brisset                 SIGnet   27:1333/3
  5707.                                                 FidoNet  2:321/7
  5708.  
  5709.  
  5710.            2) Spain
  5711.  
  5712.                  Patrick Dobeson                FidoNet  2:341/15
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.     ════════════════════════════════════════════════════════════════════════
  5719.     (C) Fabiano Fabris 1990, 1991                                    Page 81
  5720.     ════════════════════════════════════════════════════════════════════════
  5721.  
  5722.     ════════════════════════════════════════════════════════════════════════
  5723.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5724.     ════════════════════════════════════════════════════════════════════════
  5725.  
  5726.  
  5727.            3) Sweden
  5728.  
  5729.                  Andreas Birgerson              SIGnet   27:4346/200
  5730.                                                 FidoNet  2:200/407
  5731.  
  5732.  
  5733.            4) Switzerland
  5734.  
  5735.                  Roger Mella                    FidoNet  2:300/682
  5736.  
  5737.  
  5738.            5) U.S.A.
  5739.  
  5740.                  Jim Louvau                     FidoNet  1:290/4
  5741.                                                 IntlNet  56:300/0
  5742.  
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.  
  5749.  
  5750.  
  5751.  
  5752.  
  5753.  
  5754.  
  5755.  
  5756.  
  5757.  
  5758.  
  5759.  
  5760.  
  5761.  
  5762.  
  5763.  
  5764.  
  5765.  
  5766.  
  5767.  
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.  
  5781.  
  5782.  
  5783.     ════════════════════════════════════════════════════════════════════════
  5784.     (C) Fabiano Fabris 1990, 1991                                    Page 82
  5785.     ════════════════════════════════════════════════════════════════════════
  5786.  
  5787.     ════════════════════════════════════════════════════════════════════════
  5788.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5789.     ════════════════════════════════════════════════════════════════════════
  5790.  
  5791.  
  5792.      16. P.S.
  5793.  
  5794.         Oops ... in the Acknowledgements  (see Chapter 3.) I mentioned  one
  5795.         product which so far has not been named ... so here it is:
  5796.  
  5797.            Scottex Toilet Paper
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.  
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815.  
  5816.  
  5817.  
  5818.  
  5819.  
  5820.  
  5821.  
  5822.  
  5823.  
  5824.  
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830.  
  5831.  
  5832.  
  5833.  
  5834.  
  5835.  
  5836.  
  5837.  
  5838.  
  5839.  
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.     ════════════════════════════════════════════════════════════════════════
  5849.     (C) Fabiano Fabris 1990, 1991                                    Page 83
  5850.     ════════════════════════════════════════════════════════════════════════
  5851.  
  5852.     ════════════════════════════════════════════════════════════════════════
  5853.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5854.     ════════════════════════════════════════════════════════════════════════
  5855.  
  5856.  
  5857.                                  ═══ INDEX ═══
  5858.  
  5859.     ARCmail 0.6, 15                     IMAIL, 34
  5860.     Area Line, 66                       IMAIL ALNK, 47
  5861.     Area Manager                        IMAIL SCAN, 36
  5862.      # Days, 24                         IMAIL TOSS, 34
  5863.      # Messages, 25                     IMPACK, 38
  5864.      Active Status, 22                  IMSETUP, 8
  5865.      Area Comment, 22                   IMTHINGS KILL, 52
  5866.      Area Name, 22                      IMTHINGS MOVE, 54
  5867.      Board Number, 23                   IMTHINGS PACK, 57
  5868.      Export List, 25                    IMTHINGS POST, 58
  5869.      Group, 24                          IMTHINGS RECOVER, 59
  5870.      Keep Seens, 24                     IMTHINGS SEND, 60
  5871.      Origin Address, 25                 IMTHINGS SORT, 62
  5872.      Origin Line, 22                   Compressing the Message Base, 53,57
  5873.      Passthrough Areas, 23             Configuration Files
  5874.      Secure Mode, 23                    IMAIL.AR, 78
  5875.      SEEN-BY Addresses, 25              IMAIL.AX, 78
  5876.      Tiny Seens, 24                     IMAIL.CF, 78
  5877.     AreaLink, 42                        IMAIL.ND, 78
  5878.      Forward Link Requests, 45         Cross-linked Areas, 22,23,66
  5879.      Invoking, 35,37
  5880.      Local Maintainance, 47            Default Origin, 12,23
  5881.      Local Use, 47                     Deleting Messages Selectivly, 24,25,52
  5882.      Meta-Commands, 43                 Direct ARCmail, 28
  5883.      Remote Change, 46                 Disk Space
  5884.      Remote Deletion, 45                and TOSS, 35
  5885.      Remote Maintainance, 28,43        Domain Names, 9
  5886.      Replies, 45                       Dupe Message Board, 11
  5887.      Request Format, 42
  5888.     AreaLink Meta-Commands, 43         Echo Gating, 70
  5889.      ALL, 43                           Echo Mail
  5890.      FROM, 43                           Area Name, 66
  5891.      HELP, 44                           Control Information, 65
  5892.      LIST, 44                           Gating, 70
  5893.      QUERY, 44                          How it Works, 65
  5894.      RESCAN, 43,44                      How Sent, 67
  5895.      UNLINKED, 45                       Origin Line, 66
  5896.     AreaLink Options                    PATH Lines, 67
  5897.      Allow Rescan, 12                   SEEN-BY Lines, 67
  5898.      AreaLink Help Text, 13             Tear Line, 66
  5899.      Forward Link Requests, 13          Topology, 68
  5900.      Keep Receipt, 12                   What is it?, 65
  5901.     Areas with no links, 55            Echo Statistics, 63
  5902.     Areas.Bbs                          Environment variable, 2,8,78
  5903.      Export to, 32                      IMAIL, 5,11,13,64
  5904.      Import from, 31                    POINTNET, 5
  5905.     Auto-add New Areas, 15             ERRORLEVELS, 78
  5906.     Automatic Message Replies, 18,35,49 IMAIL TOSS, 34,79
  5907.  
  5908.     Bad Message Board, 11,14,17,35     Fakenets
  5909.                                         and Pack Routing, 39
  5910.     Capability, 29,77                  File Sharing, 6
  5911.     Command Line Options               FLAGS Kludge
  5912.  
  5913.     ════════════════════════════════════════════════════════════════════════
  5914.     (C) Fabiano Fabris 1990, 1991                                    Page 84
  5915.     ════════════════════════════════════════════════════════════════════════
  5916.  
  5917.     ════════════════════════════════════════════════════════════════════════
  5918.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5919.     ════════════════════════════════════════════════════════════════════════
  5920.  
  5921.  
  5922.      CFM, 72                            STAT, 63
  5923.      DIR, 71                           Inbound Subdirectory, 10
  5924.      IMM, 71                           Installation, 5
  5925.      KFS, 72                           INTHINGS
  5926.      RRQ, 72                            LINK, 54
  5927.      TFS, 72
  5928.     Forward Link Requests, 13,45       Kludges, 71
  5929.     Forwarding Routed Packets, 17       EID, 71
  5930.     FroDo/Binkey Environment, 14        FLAGS, 71
  5931.                                         FMPT, 72
  5932.     IMAIL                               INTL, 73
  5933.      ALNK, 37                           MSGID, 73
  5934.      Exit Codes, 78                     PATH, 67,69
  5935.      SCAN, 36                           PID, 73
  5936.      TOSS, 34                           REPLY, 74
  5937.     IMAIL Robot, 60                     RESCANNED, 74
  5938.     IMAIL.AR, 78                        TOPT, 74
  5939.     IMAIL.AX, 78
  5940.     IMAIL.CF, 78                       LASTREAD.BBS, 57,62
  5941.     IMAIL.DP, 78                       Linking the Message Base, 54
  5942.     IMAIL.ND, 78                       Log Files
  5943.     IMPACK, 38                          Auto-Added Areas, 11
  5944.     IMPACK Switches                     Echo Statistics, 63
  5945.      Crash Messages, 40                 IMAIL, 10
  5946.      Direct Messages, 40                Log Format, 11
  5947.      Hold Messages, 40
  5948.      No Default Pack Routing, 40       Maximum Packet Size, 16
  5949.      Pack Route Direct, 40             Message Area Rescans, 12,44
  5950.     Importing Net Mail, 51             Moving Message Areas, 54
  5951.     IMSETUP                            MSGID Kludge, 73
  5952.      AreaLink options, 12              MSGID Kludges, 9
  5953.      Compression programs, 18
  5954.      Decompression programs, 19        Net Mail Message Subdirectory, 10
  5955.      Domain names, 9                   Networks, 6
  5956.      Echo areas, 19                    Node Manager
  5957.      General Configuration, 8           Address, 27
  5958.      Import/export, 31                  Cap Handling, 29
  5959.      Node Manager, 26                   Capability, 29
  5960.      Other parameters, 14               Direct, 28
  5961.      Pack routing, 30                   Groups, 28
  5962.      Product Codes, 14                  Password, 27
  5963.      Subdirectories, 9                  Program, 29
  5964.      System addresses, 8                Remote Maintainance, 28
  5965.     IMTHINGS, 51                        Status, 28
  5966.      IMPORT, 51                        Notifying of Linked Echos, 56
  5967.      INDEX, 51                         Number of Dupe Records, 15
  5968.      KILL, 52
  5969.      MOVE, 54                          Origin Line, 22,66
  5970.      NOLINK, 55                        Outbound Subdirectory, 10
  5971.      NOTIFY, 56                        Overlay Swapping, 16
  5972.      PACK, 57
  5973.      POST, 58                          Packing Net Mail Messages, 38
  5974.      RECOVER, 59                       PATH Lines, 67
  5975.      SEND, 60                          Points
  5976.      SORT, 62                           and Pack Routing, 31,38,39
  5977.  
  5978.     ════════════════════════════════════════════════════════════════════════
  5979.     (C) Fabiano Fabris 1990, 1991                                    Page 85
  5980.     ════════════════════════════════════════════════════════════════════════
  5981.  
  5982.     ════════════════════════════════════════════════════════════════════════
  5983.           IMAIL  -  The "Semi-Intuitive" Mail Processor  -  Ver 1.21
  5984.     ════════════════════════════════════════════════════════════════════════
  5985.  
  5986.  
  5987.      SEEN-BYs & PATHs, 25              Subdirectories, 9
  5988.     Posting Messages in a Board, 58     Inbound Files, 10
  5989.     Product Codes, 14,77                Net Mail, 10
  5990.                                         Outbound Files, 10
  5991.     QBBS/RA System Subdirectory, 9      QBBS/RA System, 9
  5992.                                        System Addresses, 8
  5993.     Rebuilding Index Files, 51         System Requirements
  5994.     Recovering Deleted Messages, 59     Hardware, 6
  5995.     Remote Change, 46                   Software, 6
  5996.     Remote Deletion, 43,45
  5997.     RESCANNED Kludge, 45,74            Tear Line, 66
  5998.     Return Receipts, 17                TOSS Switches
  5999.                                         Check Bad Message Board, 35
  6000.     SCAN Switches                       No AreaLink, 35
  6001.      Force Complete SCAN, 36            No AutoReply, 35
  6002.      No Compression, 37                 No Compression, 36
  6003.     Scanning Echo Mail, 36             Tossing Echo Mail, 34
  6004.     SEEN-BY Lines, 25,67               Truncate/Delete ARCmail, 16
  6005.     Sorting the Message Base, 62
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.  
  6014.  
  6015.  
  6016.  
  6017.  
  6018.  
  6019.  
  6020.  
  6021.  
  6022.  
  6023.  
  6024.  
  6025.  
  6026.  
  6027.  
  6028.  
  6029.  
  6030.  
  6031.  
  6032.  
  6033.  
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.  
  6041.  
  6042.  
  6043.     ════════════════════════════════════════════════════════════════════════
  6044.     (C) Fabiano Fabris 1990, 1991                                    Page 86
  6045.     ════════════════════════════════════════════════════════════════════════
  6046.  
  6047.